Skip to main content
GET
/
file-storage
/
{projectId}
/
agent
/
{agentId}
curl -X GET \
  "https://bouncer.nunu.ai/file-storage/my-project/agent/a1b2c3?include_metadata=true" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "projectId": "my-project",
  "scope": "agent",
  "agentId": "a1b2c3",
  "count": 1,
  "files": [
    {
      "filename": "agent-prompt.md",
      "path": "agent-prompt.md",
      "size": 512,
      "uploaded": "2026-04-12T10:35:00.000Z",
      "etag": "1b2c3d4e5f60718a3b4c5d6e7f80909a",
      "metadata": {
        "description": "System prompt for this agent",
        "summary": "Routing rules and persona",
        "keywords": ["prompt", "agent"]
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

Permission Required: any API key scoped to the requested project
Knowledge endpoints are served by the bouncer service at https://bouncer.nunu.ai, not the main nunu.ai/api/v1 host. Use the same X-Api-Key header for authentication.
Returns the files stored under agent/{agentId}/ for the given project. These are reference files that nunu attaches to runs that use a specific agent configuration. To get project-, agent-, and test-case-scope files in a single call, use List Knowledge Files instead.

​
Path Parameters

​
projectId
string
required
The nunu.ai project ID. Must match the project the API key is scoped to.
​
agentId
string
required
The agent ID whose files you want to list.

​
Query Parameters

​
include_metadata
boolean
default:"false"
When true, attach parsed metadata (description, summary, keywords) for each file from its .{name}.meta.json sidecar.

​
Response

​
projectId
string
required
Echo of the path parameter.
​
scope
string
required
Always "agent" for this endpoint.
​
agentId
string
required
Echo of the path parameter.
​
count
integer
required
Number of files returned.
​
files
File[]
required
Files in the agent scope. See List Knowledge Files for the full file shape.
curl -X GET \
  "https://bouncer.nunu.ai/file-storage/my-project/agent/a1b2c3?include_metadata=true" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "projectId": "my-project",
  "scope": "agent",
  "agentId": "a1b2c3",
  "count": 1,
  "files": [
    {
      "filename": "agent-prompt.md",
      "path": "agent-prompt.md",
      "size": 512,
      "uploaded": "2026-04-12T10:35:00.000Z",
      "etag": "1b2c3d4e5f60718a3b4c5d6e7f80909a",
      "metadata": {
        "description": "System prompt for this agent",
        "summary": "Routing rules and persona",
        "keywords": ["prompt", "agent"]
      }
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Path Parameters

​
projectId
string
required

The nunu.ai project ID. Must match the project the API key is scoped to.

​
agentId
string
required

The agent ID whose files you want to list.

Query Parameters

​
include_metadata
boolean
default:false

When true, attach parsed metadata (description, summary, keywords) for each file from its .{name}.meta.json sidecar.

Response

Successful response

​
projectId
string
required
​
scope
enum<string>
required
Available options:
agent
​
agentId
string
required
​
count
integer
required
​
files
object[]
required