# PATCH /api/v1/workspaces/:id

Auth: Bearer

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

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

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

## Response

HTTP 200. Sample values illustrate the schema.

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

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "conflict",
    "code": "quota_below_usage",
    "docs_url": "https://cooperemail.com/docs#quota_below_usage"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.