Skip to navigation
Voice AgentsBoards

Create board

View as Markdown

Creates an empty board with one default tab, named Tab 1, at position 0. Board names do not have to be unique.

Path parameters

org_idstringRequired
Organization ID
workspace_idstringRequired
Workspace ID

Headers

X-API-KeystringRequired
Your workspace API key.

Request

This endpoint expects an object.
namestringRequired4-80 characters
Board display name, 4 to 80 characters
tagstring or nullOptional4-80 characters

Optional grouping label, 4–80 characters. Omit or send null for no tag.

Response

Successful Response
idstringformat: "uuid"

Board identifier, used as {board_id} in every nested route

namestring
Board display name
created_byobject
Actor that created the board
created_atdatetime
Creation time, UTC, RFC 3339
updated_byobject
Actor that last changed the board or anything on it
updated_atdatetime
Last change time, UTC, RFC 3339
tagstring or nullOptional
The board's grouping tag, or null when untagged

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error