Stage Runtime File | BCTRL Docs

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

AuthorizationBearer

Use Bearer <api-key>.

runtimeIdstringRequired

This endpoint expects an object.

fileIdstringRequiredformat: "uuid"

namestringOptional1-255 characters

runtimePathstringOptional1-4096 characters

expiresAtdatetime or null

idstring>=1 character

namestring1-255 characters

runtimeIdstringformat: "uuid"

runtimePathstring>=1 character

sizeBytesinteger0-9007199254740991

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.bctrl.ai/v1/runtimes/runtimeId/files/stage \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
>	}'

1	{
2	"expiresAt": "2024-07-01T12:00:00Z",
3	"id": "file-9b8c7d6e5f4a3b2c1d0e",
4	"name": "config.yaml",
5	"runtimeId": "7e4a1f2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
6	"runtimePath": "/app/config/config.yaml",
7	"sizeBytes": 2048
8	}