List artifacts

Overview

Artifacts are files your agents publish during a turn, such as a report or an export. List and inspect them here, then create a short-lived download link to fetch the bytes. Published files never change.

Endpoints

List artifactsGET/v1/artifacts

List artifacts.

Lists your tenant's artifacts newest first, 50 per page. Filter by the agent or session that published them, and pass nextCursor as cursor to get the next page.

Request

Requires bearer authentication.

Returns 200 OK as application/json. A page of artifacts.

Response schema: ArtifactList.

{
  "data": [
    {
      "artifactId": "at_6Jm2Qx8RtW4nPz1K",
      "agentId": "ag_4kP9sT2vXq7LmN3a",
      "tenantId": "ten_8Hq2Zr5WcY1bJt6D",
      "sessionId": "ss_9Fh3Lc7VbN2kDs5Y",
      "filename": "report.pdf",
      "mediaType": "application/pdf",
      "sizeBytes": 24830,
      "userId": "",
      "metadata": {},
      "createdAt": "2026-07-10T10:00:00.000Z",
      "updatedAt": "2026-07-10T10:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Errors

See REST errors for the error envelope and shared codes.

cURL

curl "$BLAZING_AGENTS_BASE_URL/v1/artifacts" \
  --header "Authorization: Bearer $BLAZING_AGENTS_API_KEY"

Create artifact download URLPOST/v1/artifacts/:artifactId/download-url

Create an artifact download URL.

Creates a link that downloads the artifact's file for five minutes. Fetch it without an API key; it works more than once until expiresAt. Anyone with the link can download the file, so keep it out of logs.

Request

Requires bearer authentication.

Returns 200 OK as application/json. The download URL and when it expires.

Response schema: ArtifactDownloadUrl.

{
  "url": "https://downloads.example.com/at_6Jm2Qx8RtW4nPz1K/report.pdf?signature=3f9a2c",
  "expiresAt": "2026-07-10T10:05:00.000Z"
}

Errors

See REST errors for the error envelope and shared codes.

cURL

curl --request POST "$BLAZING_AGENTS_BASE_URL/v1/artifacts/at_1234567890ABCDEF/download-url" \
  --header "Authorization: Bearer $BLAZING_AGENTS_API_KEY"

Get artifactGET/v1/artifacts/:artifactId

Get an artifact.

Returns an artifact's metadata without its contents. Create a download URL to fetch the file.

Request

Requires bearer authentication.

Returns 200 OK as application/json. The artifact.

Response schema: Artifact.

{
  "artifactId": "at_6Jm2Qx8RtW4nPz1K",
  "agentId": "ag_4kP9sT2vXq7LmN3a",
  "tenantId": "ten_8Hq2Zr5WcY1bJt6D",
  "sessionId": "ss_9Fh3Lc7VbN2kDs5Y",
  "filename": "report.pdf",
  "mediaType": "application/pdf",
  "sizeBytes": 24830,
  "userId": "",
  "metadata": {},
  "createdAt": "2026-07-10T10:00:00.000Z",
  "updatedAt": "2026-07-10T10:00:00.000Z"
}

Errors

See REST errors for the error envelope and shared codes.

cURL

curl "$BLAZING_AGENTS_BASE_URL/v1/artifacts/at_1234567890ABCDEF" \
  --header "Authorization: Bearer $BLAZING_AGENTS_API_KEY"

Delete artifactDELETE/v1/artifacts/:artifactId

Delete an artifact.

Permanently deletes an artifact and its file. The source file in the workspace is not touched. Deleting the same artifact again returns 404 not_found.

Request

Requires bearer authentication.

Returns 204 No Content. The artifact was deleted.

Errors

See REST errors for the error envelope and shared codes.

cURL

curl --request DELETE "$BLAZING_AGENTS_BASE_URL/v1/artifacts/at_1234567890ABCDEF" \
  --header "Authorization: Bearer $BLAZING_AGENTS_API_KEY"

Next

• Artifacts to have an agent publish files.
• Service limits for file size and count limits.