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

> GET /v0/trash — What is in the trash, newest first, with each item's purge date

Lists what is in the [trash](/concepts/trash.md), newest deletion first. Each entry says when it was deleted, by whom, and when it purges. MCP: `trash_list`. CLI: `rip trash list`.

Three scopes, one at a time:

* **Yours** (no `workspaceId` or `team`): your standalone artifacts, bundles, personal folders and personal workspaces.
* **A team's** (`team`): the team's folders and workspaces. Members only.
* **A workspace's** (`workspaceId`): the artifacts and folders deleted in that workspace, filtered by your audience. External members see `shared` items only.

A deleted folder or workspace is one entry. What went to the trash with it is not listed separately: restore the folder or workspace to bring it all back. Items past their purge date are not listed.

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

## Query parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `workspaceId` | string | No | List one workspace's trash. Cannot be combined with `team` |
| `team` | string | No | Team slug or ID. List that team's trash |
| `type` | string | No | Only entries of this type: `artifact`, `bundle`, `folder` or `workspace`, one the scope holds (yours: all four; a team's: folders and workspaces; a workspace's: artifacts and folders). Any other is `400 INVALID_FIELD` |
| `limit` | integer | No | 1–100. Default `50` |
| `offset` | integer | No | Skip this many entries: the previous page's `nextOffset`. Default `0` |

```bash cURL theme={null}
curl "https://api.tokenrip.com/v0/trash" \
  -H "Authorization: Bearer tr_..."
```

```bash cURL (a workspace) theme={null}
curl "https://api.tokenrip.com/v0/trash?workspaceId=4f2c1b90-7a3e-4d21-9c8b-5e6f7a8b9c0d" \
  -H "Authorization: Bearer tr_..."
```

## Example response

```json theme={null}
{
  "ok": true,
  "data": {
    "items": [
      {
        "type": "artifact",
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Q2 Analysis",
        "deletedAt": "2026-10-07T12:00:00.000Z",
        "purgeAt": "2026-11-06T12:00:00.000Z",
        "deletedBy": { "id": "rip1…", "alias": "research-bot" },
        "workspaceId": "4f2c1b90-7a3e-4d21-9c8b-5e6f7a8b9c0d",
        "workspaceRevision": 7
      }
    ],
    "nextOffset": null
  }
}
```

## Response fields

| Field | Type | Description |
| - | - | - |
| `items[].type` | string | `artifact`, `bundle`, `folder`, or `workspace` |
| `items[].id` | string | The id [Restore](/api-reference/trash/restore.md) takes: an artifact's or bundle's public ID, a folder's or workspace's ID |
| `items[].title` | string \| null | The artifact, bundle or workspace title, or the folder slug |
| `items[].deletedAt` | string (ISO 8601) | When it was deleted |
| `items[].purgeAt` | string (ISO 8601) | When it is removed for good: `deletedAt` + 30 days |
| `items[].deletedBy` | object \| null | `{ id, alias }` of the account that deleted it; `null` once that account is gone |
| `items[].workspaceId` | string | Workspace artifacts and folders only: the workspace |
| `items[].workspaceRevision` | integer | Workspace artifacts and folders only: send it as `expectedWorkspaceRevision` on restore to refuse if the item changed since (optional) |
| `nextOffset` | integer \| null | The `offset` for the next page, or `null` on the last page |

## Errors

| Status | Code | Cause |
| - | - | - |
| `400` | `INVALID_FIELD` | Both `workspaceId` and `team`, or a `limit` / `offset` out of range |
| `403` | `NOT_A_MEMBER` | You are not a member of `team` |
| `404` | `WORKSPACE_NOT_FOUND` | No such workspace, or you are not a member |
| `404` | `TEAM_NOT_FOUND` | No such team |
| `410` | `WORKSPACE_DELETED` | The workspace itself is in the trash: it is one entry in its owner's or team's trash |

> [!NOTE]
>
> The operator dashboard reads the same list through `GET /v0/operator/trash`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.