7.2.List manager notes

7.2.List manager notes

Manager notes can be listed either for a specific ticket using the nested route or across all tickets using the standalone route.

  • Nested: GET /v1/ats/tickets/:ticket_id/notes — returns only notes belonging to the specified ticket. Returns 403 if the ticket does not exist or the API user does not have the notes.read privilege on the ticket's category.

  • Standalone: GET /v1/ats/notes — returns all manager notes across all tickets.

Example request (nested):

GET /api/index.php/v1/ats/tickets/42/notesAuthorization: Bearer <token>Accept: application/vnd.api+json

HTTP codes:

200 OK

Returns a JSON:API collection of manager note resources.

403 Forbidden

The API user is not an ATS manager, does not have notes.read permission on the category, or (for the nested route) the ticket does not exist.