v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List a team's artifacts

Returns all artifacts owned by the specified team. Artifacts represent AI-generated or user-uploaded files associated with agent sessions, threads, or sandboxes — such as images, documents, and code outputs.

The authenticated user must be a member of the team. Attempting to list artifacts for a team the caller does not have access to returns 404 rather than 403 to avoid leaking team existence.

Results are returned in a single page without cursor pagination. Each artifact in the response reflects the state of its current version, including a short-lived signed file_url for direct download.

get/api/v1/teams/{team}/artifacts

Path parameters

teamstring required

Team ID (tea_...). The authenticated user must be a member of this team.

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
    }
  ]
}