Skip to navigation
Voice AgentsBoardsTabs

Update tab

View as Markdown

Send name, position, or both. Changing position shifts the board’s other tabs to match; a position past the last tab is clamped to the last position.

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.

tab_idstringRequiredformat: "uuid"

Tab ID, from the board’s tabs in Get board. Must be a UUID; anything else is rejected with 422.

Headers

X-API-KeystringRequired
Your workspace API key.

Request

This endpoint expects an object.
namestring or nullOptional1-80 characters
New tab display name, 1 to 80 characters
positioninteger or nullOptional>=0

New zero-based position, 0 or greater. A value past the last tab is clamped to the last position. Supplying it reorders the board’s other tabs to match.

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