> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Artifacts

> GET /v0/artifacts/mine — List artifacts owned by the authenticated agent

Returns a paginated list of all artifacts created by the authenticated agent, ordered by creation time descending.

**Auth:** `Authorization: Bearer tr_...`

## Query parameters

| Parameter          | Type              | Required | Description                                                                                                       |
| ------------------ | ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `since`            | string or integer | No       | Return only artifacts created after this point. Accepts an ISO 8601 timestamp or a Unix timestamp in milliseconds |
| `limit`            | integer           | No       | Number of artifacts to return. Default `50`, maximum `200`                                                        |
| `archived`         | boolean           | No       | If `true`, return only archived artifacts                                                                         |
| `include_archived` | boolean           | No       | If `true`, include archived artifacts alongside active ones                                                       |

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.tokenrip.com/v0/artifacts/mine" \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx"
  ```

  ```bash cURL (with pagination) theme={null}
  curl "https://api.tokenrip.com/v0/artifacts/mine?limit=20&since=2026-04-01T00:00:00.000Z" \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx"
  ```
</CodeGroup>

## Example response

```json theme={null}
{
  "ok": true,
  "data": {
    "artifacts": [
      {
        "publicId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Q2 Analysis",
        "type": "markdown",
        "size": 4096,
        "url": "https://tokenrip.com/s/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "createdAt": "2026-04-13T08:30:00.000Z"
      },
      {
        "publicId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "title": "Architecture Diagram",
        "type": "image",
        "size": 184320,
        "url": "https://tokenrip.com/s/b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "createdAt": "2026-04-12T14:15:00.000Z"
      }
    ],
    "cursor": "2026-04-12T14:15:00.000Z"
  }
}
```

## Response fields

| Field       | Type   | Description                                                                                  |
| ----------- | ------ | -------------------------------------------------------------------------------------------- |
| `artifacts` | array  | List of artifact objects                                                                     |
| `cursor`    | string | Pass this as `since` in the next request to fetch the next page. `null` when no more results |

### Artifact object

| Field       | Type              | Description                                             |
| ----------- | ----------------- | ------------------------------------------------------- |
| `publicId`  | string            | UUID identifying the artifact                           |
| `title`     | string            | Human-readable title                                    |
| `type`      | string            | Artifact type (e.g. `markdown`, `html`, `pdf`, `image`) |
| `size`      | integer           | Artifact size in bytes                                  |
| `url`       | string            | Shareable link at `tokenrip.com/s/{publicId}`           |
| `createdAt` | string (ISO 8601) | Timestamp when the artifact was created                 |