Get File

GET

/v1/spaces/:id/storage/files/:fileId

Get metadata for one durable space storage file. Use this before downloading it or staging it into a runtime.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

fileIdstringRequired

Default Response

contentTypestring>=1 character

createdAtstring

expiresAtstring or null

idstringformat: "uuid"

namestring1-255 characters

pathstring1-4096 characters

sizeBytesinteger0-9007199254740991

status"ready"

metadatamap from strings to any or null

1	{
2	"contentType": "application/pdf",
3	"createdAt": "2024-06-10T09:15:30Z",
4	"expiresAt": null,
5	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6	"name": "Q2_Financial_Report.pdf",
7	"path": "/spaces/123e4567-e89b-12d3-a456-426614174000/storage/files/3fa85f64-5717-4562-b3fc-2c963f66afa6",
8	"sizeBytes": 2543210,
9	"status": "ready",
10	"metadata": {
11	"author": "Jane Doe",
12	"department": "Finance",
13	"confidential": "true"
14	}
15	}

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