Agent Context | BCTRL Docs

curl https://api.bctrl.ai/v1/spaces/id/agent-context \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "examples": [
    null
  ],
  "limits": {},
  "links": {},
  "operations": [
    {
      "id": "op-1234",
      "method": "POST",
      "path": "/v1/spaces/9f8c7d6e-5b4a-4321-9abc-def123456789/execute",
      "whenToUse": "Use this operation to trigger a new execution run in the space."
    }
  ],
  "rules": [
    "No external network calls allowed",
    "Limit runtime memory usage to 512MB"
  ],
  "runtime": {
    "activeRunId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "capabilities": [
      "execute-scripts",
      "access-storage",
      "send-notifications"
    ],
    "id": "9f8c7d6e-5b4a-4321-9abc-def123456789",
    "name": "Primary Browser Runtime",
    "status": "active",
    "type": "browser"
  },
  "space": {
    "id": "7e4d3c2b-1a09-4f8e-b7d6-123456789abc",
    "name": "Marketing Campaign Workspace",
    "region": "us-west-2"
  },
  "version": "1.0.0"
}

Fetch a compact context bundle for an agent working in a space. Use this before deciding what to do with the space, its runtimes, storage, tools, and activity.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

runtimeIdstringOptionalformat: "uuid"

topicstringOptional>=1 character

detailenumOptional

Allowed values:

include"examples" or list of "examples"Optional

Response

Default Response

exampleslist of any

limitsmap from strings to doubles

linksmap from strings to strings

operationslist of objects

ruleslist of strings

runtimeobject or null

spaceobject

versionstring>=1 character