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
Field
Type
Description
id
string
Omit to create a category; pass to update it.
board
string
Required to create.
name
string
Required to create.
slug
string
Defaults to one made from the name.
position
integer
Where to place it, from 0 (first). Others shift to make room. Omit to keep it.
expected_version
integer
The category's version from your last read. If it changed since, the call fails instead of overwriting a newer change.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.