POST /api/v1/workspaces

Summary

Create a sub-account with its own API key (returned once) and an inbox_quota set by the parent. The key only sees that sub-account. Its inboxes and sends count toward the parent plan. Plan prices are unchanged. The same client_id returns the original workspace and api_key is null. A sub-account cannot create another workspace.

Request

{
  "name": "research",
  "inbox_quota": 2,
  "client_id": "ws-1"
}

Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

Errors

The summary and the OpenAPI operation do not name an error code.

Idempotency

client_id makes this write idempotent. Sending the same client_id again returns the original object instead of creating a duplicate.