Upload File | BCTRL Docs

Upload a durable file into a space. Use space storage for user inputs, generated files, and files that may later be staged into runtimes.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

This endpoint expects a multipart form containing a file.

filefileRequired

File bytes to upload into the space storage mount.

metadatastringOptional

Optional JSON object string with caller-owned file metadata.

namestringOptional<=255 characters

Optional display filename for the stored file.

pathstringOptional<=4096 characters

Optional relative destination path. Must not be absolute or contain . or .. path segments.

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	curl -X POST https://api.bctrl.ai/v1/spaces/id/storage/files \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: multipart/form-data" \
4	-F file=@SGVsbG8gV29ybGQ=

1	{
2	"contentType": "application/pdf",
3	"createdAt": "2024-06-01T12:00:00Z",
4	"expiresAt": "null",
5	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6	"name": "annual_report_2023.pdf",
7	"path": "documents/reports/2023",
8	"sizeBytes": 245760,
9	"status": "ready",
10	"metadata": {}
11	}