SautiDesk
SautiDesk API
Workspace configuration

Rename a ticket category

PATCH
/v1/desk/categories/{id}

Renames a category or changes its position. Tickets already closed keep the name they were closed under.

Requires: desk.admin scope, workspace owner or admin.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Path Parameters

id*string

The category's id (a UUID).

Request Body

application/json

Response

OK

Example

{  "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",  "name": "Amina Wanjiru",  "position": 1}
FieldTypeDescription
idrequiredstring (uuid)
namerequiredstringA name for it.
positionrequiredintegerWhere it sits in the list, starting at 0.
curl -X PATCH "https://api.sautidesk.com/v1/desk/categories/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Amina Wanjiru",    "position": 1  }'