Bulk delete categories

Deletes multiple category ids. Permission resource is chosen dynamically from category_type; response includes success/failed counts and per-item errors.

Request body

Content type: application/json · schema BulkDeleteCategoriesRequest

category_idsarray of stringRequired

min items 1 · max items 50

itemsstring <uuid>

category_typestringRequired

Enum: serviceticket

forceanyOf

Optional force flag; schema accepts both boolean and string boolean values.

anyOf (option 1)string

Enum: truefalse

anyOf (option 2)boolean

Response body

Success response 200 · schema BulkDeleteCategoriesResponse

dataobjectRequired

messagestringRequired

successintegerRequired

≥ 0

failedintegerRequired

≥ 0

errorsarray of object

itemsobject

Response codes

200

Bulk deletion completed.

400

Invalid request payload.

401

Authentication failed.

403

Authenticated user lacks the derived settings delete permission.

POST /api/v1/categories/bulk/delete

cURL

curl -X POST "https://algapsa.com/api/v1/categories/bulk/delete" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category_ids": [
    "01HN2K7VRB9PQ3Y0000000000"
  ],
  "category_type": "service",
  "force": "true"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/categories/bulk/delete", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "category_ids": [
      "01HN2K7VRB9PQ3Y0000000000"
    ],
    "category_type": "service",
    "force": "true"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/categories/bulk/delete");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""category_ids"": [
    ""01HN2K7VRB9PQ3Y0000000000""
  ],
  ""category_type"": ""service"",
  ""force"": ""true""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {
    "message": "string",
    "success": 0,
    "failed": 0,
    "errors": [
      {}
    ]
  }
}