Contents

API reference / Categories

Update a category

PATCH /api/v1/categories/{category}

update_category Write MCP tool

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
category required
path
string The category's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
name string
1–60 characters
Category name.
description string
up to 300 characters
What belongs here, in plain words – the AI files mentions by it.
icon string An emoji.
color string Hex colour.
position integer

Example

curl -X PATCH "https://sniffington.com/api/v1/categories/{category}" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme","description":"Invoicing software for plumbers."}'