List Spaces

GET

/v1/spaces

GET

/v1/spaces

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

200Retrieved

1 {
2   "spaces": [
3     {
4       "createdAt": "2024-05-20T09:15:00Z",
5       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6       "mounts": {
7         "ai": {
8           "allowConnections": [
9             "chatbot_01",
10             "nlp_service"
11           ],
12           "defaults": {
13             "browserUse": {
14               "connection": "browser_conn_01",
15               "model": "gpt-4-browser"
16             },
17             "stagehand": {
18               "connection": "stagehand_conn_01",
19               "model": "gpt-4-stagehand"
20             }
21           }
22         },
23         "storage": {
24           "space": "project-data-storage"
25         },
26         "vault": {
27           "allow": [
28             "read_secrets",
29             "write_secrets"
30           ],
31           "allowRawReads": false,
32           "deny": [
33             "delete_secrets"
34           ]
35         }
36       },
37       "name": "Marketing Campaign Q3",
38       "region": "us-west-2",
39       "updatedAt": "2024-06-01T12:00:00Z",
40       "subaccountId": "subacct-7890"
41     }
42   ]
43 }

List spaces visible to the current API key. A space is the task or project boundary for runtimes, storage, tools, vault access, and activity.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Response

Default Response

spaceslist of objects