Create Space | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/spaces \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Development Workspace"
}'

{
  "createdAt": "2024-06-01T09:15:00Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "mounts": {
    "ai": {
      "allowConnections": [
        "chatbot_01",
        "nlp_service"
      ],
      "defaults": {
        "browserUse": {
          "connection": "conn_browser_01",
          "model": "gpt-4-browser"
        },
        "stagehand": {
          "connection": "conn_stagehand_01",
          "model": "gpt-3.5-stagehand"
        }
      }
    },
    "storage": {
      "space": "dev_workspace_storage"
    },
    "vault": {
      "allow": [
        "read_secrets",
        "write_configs"
      ],
      "allowRawReads": false,
      "deny": [
        "delete_keys"
      ]
    }
  },
  "name": "Development Workspace",
  "region": "us-east",
  "updatedAt": "2024-06-01T09:15:00Z",
  "subaccountId": "subacct_12345"
}

Create a space to hold related runtime work. Use a space as the boundary for runtimes, storage files, tools, vault access, and activity.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

namestringRequired1-200 characters

mountsobjectOptional

regionstringOptional1-120 charactersDefaults to us-east

subaccountIdstringOptional>=1 character

Response

Default Response

createdAtstring

idstringformat: "uuid"

mountsobject

namestring>=1 character

regionstring1-120 characters

updatedAtstring

subaccountIdstring or null>=1 character