Boards

Create a board

A private board is any workspace member's to create; a shared one takes an owner or admin of the workspace. A read-only workspace — suspended by the operator, or with a trial that ran out, a canceled subscription or no plan chosen — answers 403 and creates nothing: the message says which.

post/api/boards

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/boards
  • 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
keyPrefixstring
isPrivateboolean
workspacestring

Response

Success

idstring uuid required
slugstring required
namestring required
titlestring required
keyPrefixstring required
orderinteger required
createdAtstring date-time required
archivedAtstring date-time nullable required
backgroundKind'color' | 'gradient' | 'image' nullable required
backgroundValuestring nullable required
isPrivateboolean required

Changes

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