# POST /api/v1/workspaces

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/workspaces-create

## 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

```json
{
  "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.