Create a custom classifier
POST/custom-classifiers
Creates a custom classifier dimension. Requires scope finance.custom_classifiers.write. workspace_id is taken from the token. Add values with POST /custom-classifiers/{id}/values. Pass an X-Idempotency-Key header on retries.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Custom classifier created. The Location header points at the new row.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance.custom_classifiers.write scope.
X-Idempotency-Key reused with a different body.
Schema validation failure, or company_id not in the tenant.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.