Upload Artifact

Upload a file for Hub workflows that start from uploaded inputs.

POST/v2/artifacts/upload

Upload Artifact

Upload a file and receive the `artifact_id` used by Hub routes that start from uploaded structures.

cURL
curl -X POST https://api.omtx.ai/v2/artifacts/upload \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@target.pdb;type=chemical/x-pdb"
Response
{
  "artifact_id": "11111111-1111-1111-1111-111111111111",
  "filename": "target.pdb",
  "content_type": "chemical/x-pdb",
  "size_bytes": 12345,
  "created_at": "2026-03-05T00:00:00Z",
  "gs_uri": "gs://om-upload-artifacts/user-1/11111111-1111-1111-1111-111111111111_target.pdb"
}
  • This route uses multipart upload, not JSON.
  • Unlike the JSON launch routes, this upload route does not take Idempotency-Key today.
  • Use the returned artifact_id with upload-based Hub routes such as DiffDock, FlowDock, RFD3, and BindCraft.
  • For larger uploaded files, use POST /v2/artifacts/upload-url followed by POST /v2/artifacts/finalize-upload.