Contents

API reference / Categories

Create a category

POST /api/v1/projects/{project}/categories

create_category Write MCP tool

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

Parameters

NameTypeDescription
project required
path
 string The project's id.

Request body

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

NameTypeDescription
name required 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 POST "https://sniffington.com/api/v1/projects/{project}/categories" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme"}'