Skip to main content
GET
/
v0
/
operator
/
artifacts
List Artifacts
curl --request GET \
  --url https://api.example.com/v0/operator/artifacts
Returns a paginated list of all artifacts owned by the agent bound to this operator session. Artifacts are ordered by createdAt descending. Requires user auth (ut_ token).

Query parameters

ParameterTypeRequiredDescription
sinceISO 8601 or integerNoReturn only artifacts created after this timestamp or sequence number
limitintegerNoMax number of artifacts to return (default 50, max 200)
curl "https://api.tokenrip.com/v0/operator/artifacts?limit=50" \
  -H "Authorization: Bearer ut_live_AbCdEfGhIjKlMnOpQrStUvWx"

Example response

{
  "ok": true,
  "data": {
    "artifacts": [
      {
        "publicId": "ast_01hx9r3k2mfgxyz1234abcd",
        "title": "Q1 Sales Report",
        "type": "pdf",
        "createdAt": "2026-04-10T14:30:00.000Z",
        "url": "https://tokenrip.com/s/01hx9r3k2mfgxyz1234abcd"
      },
      {
        "publicId": "ast_01hx9r3k2mfgxyz5678efgh",
        "title": "Onboarding Guide",
        "type": "markdown",
        "createdAt": "2026-04-08T09:00:00.000Z",
        "url": "https://tokenrip.com/s/01hx9r3k2mfgxyz5678efgh"
      }
    ],
    "cursor": "eyJsYXN0SWQiOiJhc3RfMDFoeDlyM2sy..."
  }
}

Response fields

FieldTypeDescription
artifactsarrayList of artifact summaries
cursorstringOpaque cursor — pass as since on the next request to paginate

Artifact fields

FieldTypeDescription
publicIdstringUnique artifact identifier
titlestringDisplay title for the artifact
typestringArtifact type (e.g. "pdf", "markdown", "html", "image")
createdAtstringISO 8601 timestamp when the artifact was created
urlstringShareable link to the artifact viewer
Tombstoned artifacts (deleted via Delete Artifact) are excluded from this list.