POST/api/v1/categories/service

Create service category

Creates a new service category for the tenant. Requires the billing settings create permission.

RBAC · service-category

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 201

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

201

Service category created successfully.

400

Validation error.

401

Authentication failed.

403

Authenticated user lacks the required permission.

POST /api/v1/categories/service

cURL

curl -X POST "https://algapsa.com/api/v1/categories/service" \
  -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", {
  method: "POST",
  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.Post, "https://algapsa.com/api/v1/categories/service");
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();

201 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"
    ]
  }
}