PATCH · Bearer

PATCH /api/v1/workspaces/:id

Summary

Change name and/or inbox_quota. An inbox_quota below the number of live inboxes returns 409 quota_below_usage and changes nothing. Expired inboxes do not count. Another parent's workspace returns 404 workspace_not_found. A sub-account key returns 403 permission_denied. MCP: cooper_update_workspace.

Request

{
  "name": "research",
  "inbox_quota": 4
}

Response

HTTP 200. Sample values illustrate the schema.

{
  "object": "workspace",
  "id": "inb_example",
  "name": "string",
  "inbox_quota": 1,
  "inboxes_used": 1,
  "account_id": "acc_example",
  "api_key_prefix": "string",
  "created_at": "2026-10-18T12:00:00.000Z"
}

Errors

  • HTTP 409 quota_below_usage
  • HTTP 404 workspace_not_found
  • HTTP 403 permission_denied

Idempotency

This route does not document Idempotency-Key or client_id.