Docs: Tool reference
admin toolset

save_category

Save a category. Creates a category on a board when id is omitted (board and name required), or renames or reorders the category with that id. Categories are user-facing: end users pick one when posting, and a post has at most one. Categories can't move between boards. Pass idempotency_key when creating. Nobody is emailed. Managers and owners.

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

Input

FieldTypeDescription
idstringOmit to create a category; pass to update it.
boardstringRequired to create.
namestringRequired to create.
slugstringDefaults to one made from the name.
positionintegerWhere to place it, from 0 (first). Others shift to make room. Omit to keep it.
expected_versionintegerThe category'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 "cat_"
workspace_idrequiredstringID with prefix "ws_"
board_idrequiredstringID with prefix "brd_"
namerequiredstring
slugrequiredstring
positionrequiredinteger
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
board_slugrequiredstring
admin_urlrequiredstring (uri)

Calling it

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

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