curl -X GET \
"https://bouncer.nunu.ai/file-storage/my-project/agent/a1b2c3?include_metadata=true" \
-H "X-Api-Key: YOUR_API_TOKEN"
const projectId = "my-project";
const agentId = "a1b2c3";
const response = await fetch(
`https://bouncer.nunu.ai/file-storage/${projectId}/agent/${agentId}?include_metadata=true`,
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
project_id = "my-project"
agent_id = "a1b2c3"
response = requests.get(
f"https://bouncer.nunu.ai/file-storage/{project_id}/agent/{agent_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"include_metadata": True},
)
data = response.json()
{
"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"]
}
}
]
}
Knowledge
List Agent-Scope Knowledge
List the knowledge files attached to a specific agent configuration in the given project.
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"
const projectId = "my-project";
const agentId = "a1b2c3";
const response = await fetch(
`https://bouncer.nunu.ai/file-storage/${projectId}/agent/${agentId}?include_metadata=true`,
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
project_id = "my-project"
agent_id = "a1b2c3"
response = requests.get(
f"https://bouncer.nunu.ai/file-storage/{project_id}/agent/{agent_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"include_metadata": True},
)
data = response.json()
{
"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"]
}
}
]
}
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.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
string
required
The nunu.ai project ID. Must match the project the API key is scoped to.
string
required
The agent ID whose files you want to list.
Query Parameters
boolean
default:"false"
When
true, attach parsed metadata (description, summary, keywords)
for each file from its .{name}.meta.json sidecar.Response
string
required
Echo of the path parameter.
string
required
Always
"agent" for this endpoint.string
required
Echo of the path parameter.
integer
required
Number of files returned.
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"
const projectId = "my-project";
const agentId = "a1b2c3";
const response = await fetch(
`https://bouncer.nunu.ai/file-storage/${projectId}/agent/${agentId}?include_metadata=true`,
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
project_id = "my-project"
agent_id = "a1b2c3"
response = requests.get(
f"https://bouncer.nunu.ai/file-storage/{project_id}/agent/{agent_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"include_metadata": True},
)
data = response.json()
{
"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
API key for authentication
Path Parameters
The nunu.ai project ID. Must match the project the API key is scoped to.
The agent ID whose files you want to list.
Query Parameters
When true, attach parsed metadata (description, summary, keywords) for each file from its .{name}.meta.json sidecar.