v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List artifacts for a thread

Returns all artifacts produced during a thread's AI conversation. Artifacts are structured outputs such as code files, documents, or generated assets created by the AI agent in response to messages in the thread.

The authenticated user must have access to the specified thread. Results are returned in a single page; there is no cursor-based pagination for this endpoint.

get/api/v1/threads/{thread}/artifacts

Path parameters

threadstring required

Thread ID (thr_...). Must be accessible to the authenticated user.

Response

Successful response

Example response

{
  "data": [
    {
      "agent": "agt_0aBcDeFgHiJkLmNoPqRsTu",
      "content_type": "application/json",
      "created_at": "2024-01-01T00:00:00Z",
      "current_version": "afv_0aBcDeFgHiJkLmNoPqRsTu",
      "description": "An example description.",
      "file": "string",
      "file_name": "Example Name",
      "file_url": "https://example.com",
      "id": "art_0aBcDeFgHiJkLmNoPqRsTu",
      "image_source": {
        "file": "fil_0aBcDeFgHiJkLmNoPqRsTu",
        "height": 600,
        "media": "med_0aBcDeFgHiJkLmNoPqRsTu",
        "mime_type": "application/json",
        "refresh_url": "https://example.com",
        "url": "https://example.com",
        "width": 800
      },
      "name": "Example Name",
      "org": "org_0aBcDeFgHiJkLmNoPqRsTu",
      "sandbox": "string",
      "team": "tem_0aBcDeFgHiJkLmNoPqRsTu",
      "thread": "thr_0aBcDeFgHiJkLmNoPqRsTu",
      "updated_at": "2024-01-01T00:00:00Z",
      "user": "usr_0aBcDeFgHiJkLmNoPqRsTu",
      "version": 1
    }
  ]
}