Create Child Workspace
POST/api/v1/workspaces
Create a customer workspace. Returns 201 if new, 200 if external_id already existed.
Nesting is one level: the customer workspace is created against the caller's own workspace, and a header cannot be used to create a second-level child. Requires Idempotency-Key header for retry safety.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
Workspace with this external_id already existed
Idempotency-Key header missing, or the request was rejected before any work started.
X-API-Key missing, invalid or revoked.
The key has no access to this workspace, or the workspace has the feature disabled.
No such resource in the key's workspace.
This Idempotency-Key was already used with a different body, or the same request is still in progress.
Response Headers
Seconds to wait before retrying.
Validation Error
Per-key rate limit exceeded.
Response Headers
Seconds to wait before retrying.