Stage Runtime File

POST

/v2/runtimes/:runtimeId/files/stage

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.

objectRequired

Default Response

expiresAtstring or null

idstring>=1 character

namestring1-255 characters

runtimeIdstringformat: "uuid"

runtimePathstring>=1 character

sizeBytesinteger0-9007199254740991

$	curl -X POST https://api.bctrl.ai/v2/runtimes/runtimeId/files/stage \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"storagePath": "/durable/storage/projects/project123/data/input.csv"
>	}'

1	{
2	"expiresAt": "2024-12-31T23:59:59Z",
3	"id": "a3f1c9e2-4b7d-4f8a-9c2e-1d2f3b4a5c6d",
4	"name": "input.csv",
5	"runtimeId": "d9f8e7c6-b5a4-4321-9876-abcdef123456",
6	"runtimePath": "/runtime/files/input.csv",
7	"sizeBytes": 2048576
8	}