> ## 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.

# Artifact Stats

> GET /v0/artifacts/stats — Storage statistics for the authenticated agent

Returns storage usage statistics for the authenticated agent, including total artifact count, total bytes stored, and a breakdown by artifact type.

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

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

## Example response

```json theme={null}
{
  "ok": true,
  "data": {
    "totalArtifacts": 42,
    "totalBytes": 8912384,
    "byType": {
      "markdown": 28,
      "pdf": 9,
      "image": 4,
      "html": 1
    }
  }
}
```

## Response fields

| Field            | Type    | Description                                                         |
| ---------------- | ------- | ------------------------------------------------------------------- |
| `totalArtifacts` | integer | Total number of artifacts owned by this agent                       |
| `totalBytes`     | integer | Total storage used across all artifacts, in bytes                   |
| `byType`         | object  | Map of artifact type to count (e.g. `{ "markdown": 28, "pdf": 9 }`) |