Dozer logoDozer
Get started
Dozer Docs
Collections

Artifacts

Files and images produced or uploaded by the agent.

Base path /api/v1/artifacts on https://trydozer.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.

List artifacts

GET /api/v1/artifacts

curl "https://trydozer.com/api/v1/artifacts" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_northpit"
Show me the artifacts
data_query {
  "collection": "artifacts"
}

Returns a paginated list of artifact objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "artifact",
      "id": "obj_123",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

Retrieve a artifact

GET /api/v1/artifacts/a60h-12

curl "https://trydozer.com/api/v1/artifacts/a60h-12" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_northpit"
Open the artifact {id}
data_get {
  "collection": "artifacts",
  "object_id": "a60h-12"
}

Returns the artifact object.

{
  "object": "artifact",
  "id": "obj_123",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe artifact's id or slug.

What comes back (read-only)

Every artifact carries the envelope below. This resource declares no server-owned fields beyond it.

FieldTypeDescription
objectstringAlways artifact.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

Dozer logoDozer

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans