StatusGator Octri Preview
POST/boards

Create a board

Creates a new board in your organization. Pass user_ids to assign organization users; without them, the board has no user assignments and does not appear in any user's web sidebar, though it remains accessible through the API. A 201 response returns the created board and its public token.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

Board details, including its name and optional organization user assignments.

boardobjectoptional
The board settings object containing the board's `name` and optional `user_ids`.

4 status codes
201Returns the created board, including its ID, name, public token, and creation and update timestamps.
dataobjectoptional
successbooleanoptional
401Returned when the request is unauthenticated.
403Returned when the request uses a read-only token.
422Returned when the board payload fails validation.

Error handling

A 401 is returned when the request is unauthenticated. A 403 is returned when the token is read-only. A 422 is returned when the board payload fails validation; include only organization user IDs you intend to assign in user_ids.