Update ticket category

Updates one ticket category by category_id. Requires ticket_settings:update permission.

RBAC · ticket_settings

Path parameters

idstring <uuid>Required

Category UUID from service_categories.category_id or categories.category_id.

Request body

Content type: application/json · schema TicketCategoryUpdateRequest

category_namestring

min length 1 · max length 255

board_idstring <uuid>

parent_categorystring <uuid>

Response body

Success response 200

dataobjectRequired

Ticket category resource from the categories table, including optional hierarchy fields. The categories table has no description/updated_by/updated_at columns.

category_idstring <uuid>Required

category_namestringRequired

parent_categorystring <uuid>Nullable

board_idstring <uuid>RequiredNullable

display_ordernumber

is_from_itil_standardbooleanNullable

created_bystring <uuid>Required

created_atstring <date-time>

tenantstring <uuid>Required

childrenarray of any

itemsany

depthnumber

pathstring

children_countnumber

Response codes

200

Ticket category updated successfully.

400

Invalid category id or request payload.

401

Authentication failed.

403

Authenticated user lacks ticket settings update permission.

404

Ticket category not found.

PUT /api/v1/categories/ticket/{id}

cURL

curl -X PUT "https://algapsa.com/api/v1/categories/ticket/{id}" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category_name": "x",
  "board_id": "01HN2K7VRB9PQ3Y0000000000",
  "parent_category": "01HN2K7VRB9PQ3Y0000000000"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/categories/ticket/{id}", {
  method: "PUT",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "category_name": "x",
    "board_id": "01HN2K7VRB9PQ3Y0000000000",
    "parent_category": "01HN2K7VRB9PQ3Y0000000000"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Put, "https://algapsa.com/api/v1/categories/ticket/{id}");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""category_name"": ""x"",
  ""board_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""parent_category"": ""01HN2K7VRB9PQ3Y0000000000""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {
    "category_id": "01HN2K7VRB9PQ3Y0000000000",
    "category_name": "string",
    "parent_category": "01HN2K7VRB9PQ3Y0000000000",
    "board_id": "01HN2K7VRB9PQ3Y0000000000",
    "display_order": 0,
    "is_from_itil_standard": false,
    "created_by": "01HN2K7VRB9PQ3Y0000000000",
    "created_at": "2026-04-18T15:22:14Z",
    "tenant": "01HN2K7VRB9PQ3Y0000000000",
    "children": [
      null
    ],
    "depth": 0,
    "path": "string",
    "children_count": 0
  }
}