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

Update service category

Updates one service category by category_id. Requires billing_settings:update permission.

RBAC · billing_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 ServiceCategoryCreateRequest

category_namestringRequired

min length 1 · max length 255

descriptionstring

max length 1000

is_activeboolean

Response body

Success response 200

dataobjectRequired

Service category resource.

tenantstring <uuid>Required

category_idstring <uuid>Required

category_namestringRequired

descriptionstringNullable

display_orderinteger

default 0

is_activebooleanRequired

created_atstring <date-time>Required

updated_atstring <date-time>Required

created_bystring <uuid>Required

updated_bystring <uuid>Required

tagsarray of string

itemsstring

Response codes

200

Service category updated successfully.

400

Invalid category id or request payload.

401

Authentication failed.

403

Authenticated user lacks billing settings update permission.

404

Service category not found.

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

cURL

curl -X PUT "https://algapsa.com/api/v1/categories/service/{id}" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category_name": "x",
  "description": "string",
  "is_active": false
}'

TypeScript

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

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

200 OK·application/json

{
  "data": {
    "tenant": "01HN2K7VRB9PQ3Y0000000000",
    "category_id": "01HN2K7VRB9PQ3Y0000000000",
    "category_name": "string",
    "description": "string",
    "display_order": 0,
    "is_active": false,
    "created_at": "2026-04-18T15:22:14Z",
    "updated_at": "2026-04-18T15:22:14Z",
    "created_by": "01HN2K7VRB9PQ3Y0000000000",
    "updated_by": "01HN2K7VRB9PQ3Y0000000000",
    "tags": [
      "string"
    ]
  }
}