Skip to main content

Helpdesk Category Endpoints

Audience​

Developers, QA, support and architects.

Summary​

The canonical category surface supports tenant-visible listing and creation. Refer to the endpoint catalog for the exact operations.

Reference Content​

Listing projects category identity, name, description and active state. Creation requires positive tenant context and a nonblank name, trims description, defaults active state to true, writes audit and returns a created category projection.

No canonical update, deactivate or delete operation is registered. Compatibility ticket creation can create a missing category implicitly using permissive defaults.

Requires confirmation​

Reference-data administration authorization, duplicate error mapping, update/retirement API and compatibility-created taxonomy require confirmation.

Source References​

  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/HelpdeskDbContext.cs

See Also​

Keywords​

Category API, ticket classification, reference data.

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20