Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.

Headers

Idempotency-Key
string
required

Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.

Required string length: 1 - 200
Example:

"booking-create-20260714-001"

Body

application/json
name
object[]
required

Localized category name. Each entry must have a non-empty lang and value.

Minimum array length: 1
Example:
icon
string

Optional emoji or icon identifier for the category.

Example:

"🏋️"

order
integer

Optional zero-based position. Omit to auto-append at the end.

Example:

0

status
boolean

Defaults to true when omitted.

Example:

true

Response

Full category document after creation and order normalisation.

data
object
required
meta
object
required