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

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 ticket_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>

descriptionstring

max length 1000

Response body

Success response 200

dataobjectRequired

Ticket category resource from ticket_categories, including optional hierarchy fields.

category_idstring <uuid>Required

category_namestringRequired

parent_categorystring <uuid>Nullable

board_idstring <uuid>Required

descriptionstringNullable

created_bystring <uuid>Required

updated_bystring <uuid>Required

created_atstring <date-time>

updated_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",
  "description": "string"
}'

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",
    "description": "string"
  })
});
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"",
  ""description"": ""string""
}", 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",
    "description": "string",
    "created_by": "01HN2K7VRB9PQ3Y0000000000",
    "updated_by": "01HN2K7VRB9PQ3Y0000000000",
    "created_at": "2026-04-18T15:22:14Z",
    "updated_at": "2026-04-18T15:22:14Z",
    "tenant": "01HN2K7VRB9PQ3Y0000000000",
    "children": [
      null
    ],
    "depth": 0,
    "path": "string",
    "children_count": 0
  }
}