Create workspace
POST/v1/workspaces
Requires a src=system token. The workspace is created inside the token organization. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Success.
Body failed Zod validation. error.details carries formErrors/fieldErrors.
Authentication failed (missing/invalid JWT or mTLS).
Authenticated but the scope is insufficient or the resource is out of reach.
Resource not found or filtered out by soft-delete.
Unique constraint violated (e.g. external_id or inbox email already in use).
Body validation that requires server-side context (e.g. inbox domain mismatch).