Stage File | BCTRL Docs

Copy a durable space storage file into a live runtime. Use this when an agent or automation step needs a local file path inside the runtime.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

runtimeIdstringRequired

This endpoint expects an object.

objectRequired

Default Response

expiresAtstring or null

idstring>=1 character

namestring1-255 characters

pathstring>=1 character

runtimeIdstringformat: "uuid"

sizeBytesinteger0-9007199254740991

1	curl -X POST https://api.bctrl.ai/v1/spaces/id/runtimes/runtimeId/files/stage \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"storagePath": "/durable/storage/projects/project123/data/config.yaml"
6	}'

1	{
2	"expiresAt": "2024-12-31T23:59:59Z",
3	"id": "file-9a8b7c6d5e4f3a2b1c0d",
4	"name": "config.yaml",
5	"path": "/runtime/local/config.yaml",
6	"runtimeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
7	"sizeBytes": 2048
8	}