Update Space | BCTRL Docs

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

{
  "createdAt": "2024-06-01T09:15:30Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "mounts": {
    "ai": {
      "allowConnections": [
        "connAlpha_01",
        "connBeta-02"
      ],
      "defaults": {
        "browserUse": {
          "connection": "connAlpha_01",
          "model": "gpt-4-browser"
        },
        "stagehand": {
          "connection": "connBeta-02",
          "model": "stagehand-v2"
        }
      }
    },
    "storage": {
      "space": "project_data_storage"
    },
    "vault": {
      "allow": [
        "readSecrets",
        "writeSecrets"
      ],
      "allowRawReads": false,
      "deny": [
        "deleteSecrets"
      ]
    }
  },
  "name": "Development Workspace",
  "region": "us-west-2",
  "updatedAt": "2024-06-10T16:45:00Z",
  "subaccountId": "subacct-7890"
}

Update a space name or mounts. Use this to adjust the task boundary that owns runtimes, storage, tools, vault access, and activity.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Request

This endpoint expects an object.

mountsobjectOptional

namestringOptional1-200 characters

Response

Default Response

createdAtstring

idstringformat: "uuid"

mountsobject

namestring>=1 character

regionstring1-120 characters

updatedAtstring

subaccountIdstring or null>=1 character