Artifacts

Artifacts provide output storage for agents. Use these endpoints to list and retrieve work products created by agents during execution.

List Artifacts

GET /v1/artifacts

Returns a paginated list of your artifacts.

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	20	Items per page (1-100)
`cursor`	string	-	Pagination cursor

Request

curl https://api.vm0.ai/v1/artifacts \
  -H "Authorization: Bearer vm0_live_xxx"

Response

{
  "data": [
    {
      "id": "art_abc123",
      "name": "research-output",
      "currentVersionId": "v1_xyz789",
      "size": 524288,
      "fileCount": 5,
      "createdAt": "2024-01-15T00:00:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  }
}

Get Artifact

GET /v1/artifacts/:id

Retrieves artifact details including current version information.

Path Parameters

Parameter	Type	Description
`id`	string	Artifact ID

Request

curl https://api.vm0.ai/v1/artifacts/art_abc123 \
  -H "Authorization: Bearer vm0_live_xxx"

Response

{
  "id": "art_abc123",
  "name": "research-output",
  "currentVersionId": "v1_xyz789",
  "size": 524288,
  "fileCount": 5,
  "currentVersion": {
    "id": "v1_xyz789",
    "artifactId": "art_abc123",
    "size": 524288,
    "fileCount": 5,
    "message": "Research complete",
    "createdBy": "agent_run_abc",
    "createdAt": "2024-01-15T10:30:00Z"
  },
  "createdAt": "2024-01-15T00:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

List Artifact Versions

GET /v1/artifacts/:id/versions

Returns a paginated list of all versions for an artifact.

Path Parameters

Parameter	Type	Description
`id`	string	Artifact ID

Request

curl https://api.vm0.ai/v1/artifacts/art_abc123/versions \
  -H "Authorization: Bearer vm0_live_xxx"

Response

{
  "data": [
    {
      "id": "v1_xyz789",
      "artifactId": "art_abc123",
      "size": 524288,
      "fileCount": 5,
      "message": "Research complete",
      "createdBy": "agent_run_abc",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  }
}

Download Artifact

GET /v1/artifacts/:id/download

Returns a 302 redirect to a presigned URL for downloading the artifact as a tar.gz archive.

Path Parameters

Parameter	Type	Description
`id`	string	Artifact ID

Query Parameters

Parameter	Type	Description
`versionId`	string	Specific version (defaults to current)

Request

curl -L "https://api.vm0.ai/v1/artifacts/art_abc123/download" \
  -H "Authorization: Bearer vm0_live_xxx" \
  -o artifact.tar.gz

Response

Returns 302 Found with a Location header pointing to the presigned download URL.

HTTP/1.1 302 Found
Location: https://storage.example.com/presigned-url-for-archive.tar.gz

Artifact Object

Field	Type	Description
`id`	string	Unique artifact identifier (prefix: `art_`)
`name`	string	Artifact name
`currentVersionId`	string	ID of the current version
`size`	integer	Total size in bytes
`fileCount`	integer	Number of files
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last update timestamp

Version Object

Field	Type	Description
`id`	string	Unique version identifier
`artifactId`	string	Parent artifact ID
`size`	integer	Version size in bytes
`fileCount`	integer	Number of files in version
`message`	string	Commit message
`createdBy`	string	User or agent that created the version
`createdAt`	string	ISO 8601 creation timestamp

On this page