Workspaces

Create a workspace; the caller becomes its owner

Requires unbound admin token scope or the web session. Read and write tokens receive 403 FORBIDDEN. Every workspace-bound token receives 403 FORBIDDEN (Workspace-bound tokens cannot create workspaces), before writes or idempotency replay. On a billing-enabled installation the first workspace a person creates starts their one 14-day trial; a workspace created after that is read-only until a plan is chosen. A self-hosted installation has neither.

post/api/workspaces

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/workspaces
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Opaque 1–200 character key. The same user, endpoint, and key replay the cached response for 24 hours when the request body fingerprint matches. A reused key with a different body answers 422 IDEMPOTENCY_KEY_REUSED; the same key while the original is still in flight answers 409 CONFLICT.

Request body

namestring required

Response

Success

idstring uuid required
slugstring required
namestring required
role'owner' required

Changes

No recorded changes to this operation across all 1 revision of this API.