GET/api/v1/categories/ticket/tree/{boardId}

Get ticket category tree by board

Returns hierarchical ticket categories for a board route. Current controller still derives board id from the last path segment instead of reading req.params directly; this works for this route because the last segment is boardId.

RBAC · ticket_settings

Path parameters

boardIdstring <uuid>Required

Board UUID used by ticket category tree queries.

Response body

Success response 200 · schema CategoryTreeResponse

dataobjectRequired

treearray of anyRequired

Hierarchical category tree nodes from CategoryService.getCategoryTree.

itemsany

total_categoriesintegerRequired

≥ 0

Response codes

200

Category tree returned successfully.

400

Invalid board id format.

401

Authentication failed.

403

Authenticated user lacks ticket settings read permission.

500

Unexpected category tree failure.

GET /api/v1/categories/ticket/tree/{boardId}

cURL

curl -X GET "https://algapsa.com/api/v1/categories/ticket/tree/{boardId}" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/categories/ticket/tree/{boardId}", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/v1/categories/ticket/tree/{boardId}");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {
    "tree": [
      null
    ],
    "total_categories": 0
  }
}