7.4.Create a manager note — POST /v1/ats/tickets/:ticket_id/notes

7.4.Create a manager note — POST /v1/ats/tickets/:ticket_id/notes

Creates a new internal manager note on an existing ticket. Use the nested route to associate the note with a ticket via the URL, or include ticket_id in the JSON body when posting to /v1/ats/notes.

Request body fields:

ticket_id (integer, required unless in URL)

ID of the ticket to attach the note to.

note_html (string, required)

HTML content of the manager note.

enabled (integer, optional)

Publication state: 1 = published (default), 0 = unpublished. Only accepted from users with core.edit.state permission.

created_by (integer, optional)

Override the note author. Only accepted when the API user has core.admin on com_ats.

Note

The fields created, modified, and modified_by are always ignored and set automatically.

Example request:

POST /api/index.php/v1/ats/tickets/42/notesAuthorization: Bearer <token>Accept: application/vnd.api+jsonContent-Type: application/json{  "ticket_id": 42,  "note_html": "<p>Customer confirmed on the phone. Will send debug log.</p>"}

HTTP codes:

200 OK

Note created successfully. Returns the new manager note resource.

400 Bad Request

A required field is missing or the save operation failed.

403 Forbidden

The API user does not have notes.create permission on the ticket's category, or the ticket does not exist.