Get Space

GET

/v1/spaces/:id

GET

/v1/spaces/:id

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

200Retrieved

1 {
2   "createdAt": "2024-06-01T09:15:30Z",
3   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4   "mounts": {
5     "ai": {
6       "allowConnections": [
7         "default-ai-connection",
8         "analytics-engine"
9       ],
10       "defaults": {
11         "browserUse": {
12           "connection": "default-ai-connection",
13           "model": "gpt-4-browser"
14         },
15         "stagehand": {
16           "connection": "stagehand-conn-01",
17           "model": "stagehand-v2"
18         }
19       }
20     },
21     "storage": {
22       "space": "project-data-storage"
23     },
24     "vault": {
25       "allow": [
26         "read-secrets",
27         "write-secrets"
28       ],
29       "allowRawReads": false,
30       "deny": [
31         "delete-secrets"
32       ]
33     }
34   },
35   "name": "Marketing Campaign Space",
36   "region": "us-west-2",
37   "updatedAt": "2024-06-10T16:45:00Z",
38   "subaccountId": "subacct-7890"
39 }

Get one space and its configuration. Use this before creating runtimes, reading storage, or attaching tools inside that task boundary.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Response

Default Response

createdAtstring

idstringformat: "uuid"

mountsobject

namestring>=1 character

regionstring1-120 characters

updatedAtstring

subaccountIdstring or null>=1 character