/v1/boards/{id}Rename a board or switch its view to table or kanban
Changes a custom board's name, its purpose, the view it opens in (unchosen, table or kanban), or its recordTabs: which tabs the board's record pop-up shows besides Overview — send activity, notes, files and tasks on every board, plus calls when the rows carry a phone or email column — fewer only when the person asks for fewer. Stored deduplicated in that order; null goes back to the app's default set, and a field left out is unchanged. A board made by post_boards_import or post_boards_import_auto takes them on the import itself. Nothing about its columns or its rows moves. Needs manage on the board. purpose is the board's goal: a conversation filed on one of its records carries it as board_goal.
Access class: board:manage.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredValues: "kanban" · "table" · "unchosen"
Responses
the action's answer
{
"data": {
"access": "string",
"canShare": true,
"columns": [
{
"calculation": "string",
"config": {},
"id": "",
"kind": "string",
"label": "string",
"options": [
{
"groupLabel": "string",
"id": "",
"label": "string",
"position": 1.5,
"tone": "string",
"value": "string"
}
],
"position": 1.5,
"starred": true
}
],
"createdAt": "2026-01-01T00:00:00Z",
"definitionKey": "string",
"id": "",
"name": "string",
"purpose": "string",
"recordTabs": [
"string"
],
"rowCount": 1,
"rows": [
{
"assignees": "string",
"cells": {},
"createdBy": "string",
"externalId": "",
"id": "",
"position": 1.5
}
],
"updatedAt": "2026-01-01T00:00:00Z",
"view": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}