---
title: "List files uploaded directly to the agent"
method: GET
path: "/v1/agents/{id}/knowledge-bases/uploaded-files"
---

# List files uploaded directly to the agent

`GET /v1/agents/{id}/knowledge-bases/uploaded-files`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/agents/{id}/knowledge-bases/uploaded-files`
- Auth: HTTP bearer

Returns the files attached directly to the agent as a knowledge-base source, including both pending uploads and files that have finished embedding. Returns an empty array when the agent has no uploaded files. 404 is reserved for agent-not-found.

## Path parameters

- `id` string, uuid, required: The ID of the agent to retrieve

## Response `200`

Default Response

- object
  - `uploadedFiles` UploadedFile[], required
    - `id` string, required: File identifier
    - `name` string, required: Original file name
    - `mimeType` string, required: File MIME type
    - `size` integer, required: File size in bytes
    - `uploadedAt` string, required: ISO 8601 timestamp when the file was uploaded

## Other responses

- `404`: Default Response

---

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