Artifact Endpoints

Initiate Chunked Upload

POST /v1/versions/:versionId/artifacts/initiate

Start a chunked upload session.

Request Body:

{
  "filename": "my_package.tar.gz",
  "total_size": 104857600,
  "content_type": "application/gzip"
}

Response:

{
  "artifact_id": "art_abc123",
  "upload_id": "upl_xyz789",
  "chunk_size": 5242880
}

Upload Chunk

POST /v1/artifacts/:artifactId/chunks

Upload a file chunk.

Headers:

• Content-Type: application/octet-stream
• X-Chunk-Number: 1

Body: Binary data

Complete Upload

POST /v1/artifacts/:artifactId/complete

Finalize the upload.

Request Body:

{
  "checksum": "sha256:abc123..."
}

Download Artifact

GET /v1/artifacts/:artifactId/download

Download an artifact (returns redirect to S3 URL).

List Artifacts

GET /v1/versions/:versionId/artifacts

List all artifacts for a version.

Delete Artifact

DELETE /v1/artifacts/:artifactId

Delete an artifact.