Docs: Tool reference
admin toolset

save_status

Save a status. Creates a status when id is omitted (name and type required), or updates the status with that id. type drives reports and the roadmap: open, active, complete or closed. is_default: true makes it the status new posts get (the previous default stops being one). Names are unique, ignoring case. See current statuses in get_workspace_overview. Nobody is emailed. Managers and owners.

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

Input

FieldTypeDescription
idstringOmit to create a status; pass to update it.
namestringRequired to create.
colorstringDefaults to a color for the type.
typeone of: open, active, complete, closedRequired to create.
show_on_public_roadmapbooleanDefault false.
is_defaultboolean
positionintegerWhere to place it, from 0 (first). Others shift. Omit to keep it.
expected_versionintegerThe status's version from get_workspace_overview. 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 "sts_"
workspace_idrequiredstringID with prefix "ws_"
namerequiredstring
colorrequiredstring
typerequiredone of: open, active, complete, closedopen: new or unreviewed. active: accepted or in progress. complete: shipped. closed: won't do.
positionrequiredinteger
show_on_public_roadmaprequiredboolean
is_defaultrequiredbooleanNew posts get this status. Exactly one status is default.
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
admin_urlrequiredstring (uri)

Calling it

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

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