Create or update workspace
PUT/v1/workspaces
Upsert. Takes the same body as POST plus the lookup keys id and external_id, matched in that order. A match is updated in place and returns 200 — fields absent from the body keep their stored value. No key, or no match, creates the workspace exactly as POST would and returns 201. 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. Requires a src=system token; external_id cannot be changed on a matched workspace (409).
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Success.
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).