v1

latestOpenAPI 3.0.02026-07-26492143.5 KB

Artifacts

List artifacts

List artifacts (files) produced by an agent. Optionally scope to a specific session, search by filename, sort, and paginate.

get/agents/{agent_id}/artifacts

Path parameters

agent_idstring required

ID of the agent whose artifacts to list.

Query parameters

session_idstring

Filter to artifacts produced within a specific session.

search_querystring

Case-insensitive substring match against the artifact filename.

sort_orderstring

Sort order for results. Defaults to newest.

page_sizeinteger

Number of artifacts to return per page. Clamped to 1–100.

cursorstring

Opaque pagination cursor returned by a prior call as next_cursor.

Response

Artifacts matching the provided filters.

next_cursorstring nullable

Cursor to pass as cursor on the next request. null when there are no more results.

Example response

{
  "artifacts": [
    {
      "id": "art_aBcDeF123",
      "version_id": "ver_xYz9012",
      "major_version": 2,
      "agent_id": "abc123DEFghiJKL",
      "session_id": "ses_8h2k4m1n",
      "filename": "q4_sales_report.pdf",
      "created_at": "2026-05-15T14:32:00Z",
      "url": "https://storage.googleapis.com/...",
      "creator": {
        "id": "user_19a3bc",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "profile_picture": "https://example.com/avatars/ada.png"
      }
    }
  ]
}