Skip to navigation
Voice AgentsBoardsTabs

Create tab

View as Markdown

Appends a tab after the board’s existing tabs. A new board already has Tab 1 at position 0, so the first tab you add lands at position 1. A board holds at most 10 tabs; adding another returns 400.

Path parameters

org_idstringRequired
Organization ID
workspace_idstringRequired
Workspace ID
board_idstringRequiredformat: "uuid"

Board ID, as returned in id by Create board or List boards. Must be a UUID; anything else is rejected with 422.

Headers

X-API-KeystringRequired
Your workspace API key.

Request

This endpoint expects an object.
namestringRequired1-80 characters
Tab display name, 1 to 80 characters

Response

Successful Response
idstringformat: "uuid"
Tab identifier
namestring
Tab display name
positioninteger

Zero-based left-to-right position on the board

Errors

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