v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List a user's artifacts

Returns all artifacts owned by the specified user. 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 requesting their own artifacts or must have administrative access. Attempting to list artifacts for a user the caller is not authorized to access returns 403.

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/users/{user}/artifacts

Path parameters

userstring required

User ID (usr_...). The authenticated user must be this user or have access to their artifacts.

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