Create Artifact Upload URL

Create a short-lived signed upload URL for a user artifact.

POST/v2/artifacts/upload-url

Create Artifact Upload URL

Return a signed URL session for direct upload into the canonical uploaded-artifacts bucket.

cURL

curl -X POST https://api.omtx.ai/v2/artifacts/upload-url \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "target.pdb",
    "content_type": "chemical/x-pdb",
    "size_bytes": 12345
  }'

Response

{
  "artifact_id": "11111111-1111-1111-1111-111111111111",
  "filename": "target.pdb",
  "content_type": "chemical/x-pdb",
  "size_bytes": 12345,
  "upload_url": "https://storage.googleapis.com/...",
  "method": "PUT",
  "required_headers": {
    "Content-Type": "chemical/x-pdb"
  },
  "upload_expires_at": "2026-03-31T12:30:00Z",
  "max_size_bytes": 52428800
}

Use this route when you want direct GCS upload instead of multipart upload through the Om API.
The signed URL is short-lived and must be used before upload_expires_at.
After the PUT upload completes, call POST /v2/artifacts/finalize-upload to mint canonical artifact metadata.