List Files

GET

/v1/spaces/:id/storage/files

List durable files stored in a space. Use this to find user inputs, generated files, or files that can be staged into live runtimes.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

prefixstringOptional1-4096 characters

limitintegerOptional<=500

cursorstringOptional1-1000 characters

Default Response

fileslist of objects

nextCursorstring or null

1	{
2	"files": [
3	{
4	"contentType": "application/pdf",
5	"createdAt": "2024-06-10T09:15:30Z",
6	"expiresAt": null,
7	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
8	"name": "project_proposal.pdf",
9	"path": "/spaces/abc123/storage/project_proposal.pdf",
10	"sizeBytes": 245760,
11	"status": "ready",
12	"metadata": {
13	"uploadedBy": "user123",
14	"description": "Project proposal document"
15	}
16	}
17	],
18	"nextCursor": null
19	}

1	curl https://api.bctrl.ai/v1/spaces/id/storage/files \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"