Skip to main content

Helpdesk Comment Endpoints

Audience​

Developers, QA, security and support.

Summary​

One canonical operation appends a comment to a tenant-visible ticket.

Reference Content​

The body is required and trimmed. Author identity falls back from request values to current context and requester identity. The internal flag is accepted from the request. Creation writes comment, audit, timeline and TicketCommentAdded outbox rows and returns CommentDto with a created response.

No API operation lists comments independently, edits/deletes them or verifies permission to create/read internal comments. Ticket detail includes all loaded comments.

Requires confirmation​

Internal-comment authorization/filtering, requester-visible replies, edit/delete policy and notification audience behavior require confirmation.

Source References​

  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/Persistence.cs
  • microservices/src/notification-service/Application/EventNotificationResolver.cs

See Also​

Keywords​

Comment API, internal comment, author identity, comment event.

Revision Information​

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