Collect Runtime File

curl -X POST https://api.bctrl.ai/v2/runtimes/runtimeId/files/collect \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "path": "/var/logs/runtime/output.log"
}'

{
  "contentType": "text/plain",
  "createdAt": "2024-06-01T12:00:00Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "output.log",
  "path": "/space/storage/output.log",
  "sizeBytes": 2048,
  "source": "runtime",
  "type": "log",
  "downloadUrl": "https://storage.bctrl.ai/files/123e4567-e89b-12d3-a456-426614174000/download",
  "expiresAt": "2024-06-08T12:00:00Z",
  "metadata": {},
  "runId": "987e6543-e21b-12d3-a456-426614174999",
  "runtimeId": "456e7890-e12b-12d3-a456-426614174abc",
  "spaceId": "789e1234-e56b-12d3-a456-426614174def"
}

Copy a runtime-local file back into durable space storage.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runtimeIdstringRequired

Request

This endpoint expects an object.

pathstringRequired1-4096 characters

artifactobjectOptional

namestringOptional1-255 characters

storagePathstringOptional1-4096 characters

Response

Default Response

contentTypestring>=1 character

createdAtstring

idstringformat: "uuid"

namestring>=1 character

pathstring>=1 character

sizeBytesinteger0-9007199254740991

sourceenum

Allowed values:

typestring>=1 character

downloadUrlstring

expiresAtstring or null

metadataobject or null

runIdstring or nullformat: "uuid"

runtimeIdstring or nullformat: "uuid"

spaceIdstringformat: "uuid"