---
title: "List Agent Files"
method: GET
path: "/api/agents/{agent_id}/files"
tags: ["agent-files"]
---

# List Agent Files

`GET /api/agents/{agent_id}/files`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_id}/files`
- Auth: none declared

List the caller's own files vaulted in this agent's private file vault.

Subject-scoped to the CALLER: returns only files vaulted under the
caller's own identity, never another owner's, even when the caller is a
co-owner of the agent. Each entry is metadata only - content hash, file
name, MIME type, size in bytes, retention policy, and source provenance
(e.g. the originating mailbox message) - never the file's raw bytes.
Requires the caller to be an active owner of the agent.

Keyset-paginated (TOS-3280): without ``cursor`` returns the most recently
vaulted files first; pass the previous response's ``next_cursor`` to load
older ones. 400 on a malformed cursor.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- AgentFileListResponse: A keyset-paginated page of vaulted files (TOS-3280). ``next_cursor`` is ``None`` exactly when no further files remain; pass it back as ``cursor`` to fetch the next page. A non-``None`` value IS the truncation signal - there is no separate ``truncated`` flag to check.
  - `files` AgentFileMetadata[], required
    - `content_hash` string, required
    - `file_name` string, required
    - `mime_type` string, required
    - `size_bytes` integer, required
    - `retention` string, required
    - `source` object, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/ce2c2ce318b1?raw)