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

{
  "projectId": "my-project",
  "scope": "test_case",
  "testCaseId": "t1t2t3",
  "count": 1,
  "files": [
    {
      "filename": "expected-flow.md",
      "path": "expected-flow.md",
      "size": 2048,
      "uploaded": "2026-04-12T10:40:00.000Z",
      "etag": "2c3d4e5f60718a3b4c5d6e7f80909a1b",
      "metadata": {
        "description": "Expected user flow for this test",
        "summary": "Steps and acceptance criteria",
        "keywords": ["flow", "acceptance"]
      }
    }
  ]
}

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 test_case/{testCaseId}/ for the given project. These are reference files attached to a specific test case—nunu delivers them to runs that execute that test. 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.
​
testCaseId
string
required
The test case 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 "test_case" for this endpoint.
​
testCaseId
string
required
Echo of the path parameter.
​
count
integer
required
Number of files returned.
​
files
File[]
required
Files in the test case scope. See List Knowledge Files for the full file shape.
curl -X GET \
  "https://bouncer.nunu.ai/file-storage/my-project/test_case/t1t2t3?include_metadata=true" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "projectId": "my-project",
  "scope": "test_case",
  "testCaseId": "t1t2t3",
  "count": 1,
  "files": [
    {
      "filename": "expected-flow.md",
      "path": "expected-flow.md",
      "size": 2048,
      "uploaded": "2026-04-12T10:40:00.000Z",
      "etag": "2c3d4e5f60718a3b4c5d6e7f80909a1b",
      "metadata": {
        "description": "Expected user flow for this test",
        "summary": "Steps and acceptance criteria",
        "keywords": ["flow", "acceptance"]
      }
    }
  ]
}

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.

​
testCaseId
string
required

The test case 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:
test_case
​
testCaseId
string
required
​
count
integer
required
​
files
object[]
required