Docs: Tool reference
admin toolset

save_board

Save a board. Creates a board when id is omitted, or updates the board with that id (only the fields you pass change). Public boards (Everyone in the app) appear on the portal; private ones (Team only) only to the team; custom ones (Limited) to the team and end users matching access_rules (identified users, segments, verified email domains or invited emails). anonymize_users hides customers' names from other customers. The slug becomes the portal URL and defaults to one made from the name. Pass idempotency_key when creating so a retry doesn't make a second board. Managers and owners. Nobody is emailed.

Toolset
admin
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/boards
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
idstringOmit to create a board; pass to update that board.
namestringRequired to create.
slugstring
descriptionstring or null
accessone of: public, private, custompublic (default; Everyone in the app): on the portal. private (Team only): team members only. custom (Limited): the team plus end users matching access_rules.
access_rulesobjectWho may see a custom board; an end user matching any rule gets in. Lists you pass replace the current ones; omitted lists stay.
posting_enabledbooleanWhether end users can submit posts (default true).
voting_enabledbooleanWhether end users can vote (default true). The team can still add votes.
anonymize_usersbooleanShow customers to other customers as stable aliases (default false).
create_formobjectWording on the public post form: title_label, title_placeholder, details_label, details_placeholder, button_label. Fields you pass change; null restores the default.
require_moderationbooleanHold end users' new posts for review before others see them (default false).
form_fieldsarray of stringPublic post fields (keys or IDs) on the board's submit form, in order, at most 5; [] removes them all.
positionintegerWhere to place it, from 0 (first). Others shift to make room. Omit to keep it.
expected_versionintegerThe board's version from your last read. If it changed since, the call fails instead of overwriting a newer change.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstringID with prefix "brd_"
workspace_idrequiredstringID with prefix "ws_"
slugrequiredstring
namerequiredstring
descriptionrequiredstring or null
accessrequiredone of: public, private, custompublic (Everyone in the app): anyone can see it on the portal. private (Team only): team members only. custom (Limited): the team plus end users matching access_rules.
posting_enabledrequiredbooleanWhether end users can submit posts to this board.
voting_enabledrequiredbooleanWhether end users can vote on this board's posts.
create_formrequiredobjectLabels and placeholders on the public post form.
anonymize_usersrequiredbooleanEnd users see other customers under stable aliases ("Anonymous Otter"); the team sees real names.
require_moderationrequiredbooleanEnd users' new posts wait for the team's approval before others see them.
positionrequiredintegerOrder on the portal and in admin, from 0.
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
access_rulesrequiredobject or nullFor custom boards, who may see it; null for other boards and for end users.
form_fieldsrequiredarray of objectCustom fields on the board's public post form, in order (create_post fields).
portal_urlrequiredstring (uri)
admin_urlrequiredstring (uri) or nullAdmin settings page; null for end users.

Calling it

// MCP: tools/call
{ "name": "save_board", "arguments": {} }

// Typed client
await carechannel.save_board({});