Skip to main content
PUT
Update an existing category

Authorizations

Authorization
string
header
required

API-Token aus dem Big-Panda-Admin-UI unter Einstellungen → API-Keys. Header: Authorization: Bearer <token>.

Path Parameters

category_id
string<uuid>
required

Body

application/json

Payload for updating an existing category.

All fields are optional. Only fields that are explicitly provided will be modified — other fields keep their current value.

Note: parent_id can be set to null explicitly to move a category to the top level. Pydantic distinguishes "not in payload" from "explicitly null" via model_fields_set.

name
string | null
Required string length: 1 - 200
description
string | null
parent_id
string<uuid> | null
sort_order
integer | null
Required range: x >= 0

Response

Successful Response

Category data returned in HTTP responses.

name
string
required
Required string length: 1 - 200
id
string<uuid>
required
tenant_id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
parent_id
string<uuid> | null

UUID of the parent category, or null for a top-level category

sort_order
integer
default:0
Required range: x >= 0