API ReferenceFiles

List files

GET /api/v1/files — paginated list of files.

GET /api/v1/files

Query parameters

Param	Type	Default	Notes
`status`	string	—	Filter by processing status (`pending`, `processing`, `completed`, `failed`).
`limit`	int (1..100)	`50`
`offset`	int (≥0)	`0`

{
  "files": [ /* FileResponse, same shape as POST /files */ ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

curl "https://dashboard.zoxa.ai/api/v1/files?status=completed&limit=20" \
  -H "X-API-Key: zsk_..."

Create a file from text

POST /api/v1/files/text — create a `.txt` file from inline text content.

Get a file

GET /api/v1/files/{file_id} — fetch one file's metadata and processing status.