createRequestNote | Atomicwork

Add a note to a request.

Adds a note (comment/reply) to an existing request ticket. Notes are the primary communication mechanism within a ticket — use them to post investigation findings, troubleshooting steps, resolution summaries, or any other updates.

Parameters

Name	Type	Required	Description
`requestId`	string	Yes	The request display ID (e.g., REQ-123, INC-456)
`user_id`	integer	No
`conversation_id`	integer	No	When set, the reply is mirrored into this conversation’s thread (UAG).
`description`	string	No
`mentions`	integer[]	No	User IDs mentioned in the note. Mentioned users are notified and added as direct followers.
`agent_group_mentions`	integer[]	No	Agent group IDs mentioned in the note. Members of these groups are notified
`is_private`	boolean	No	Default: `False`.
`source`	object	No
`type`	object	No
`attachments`	integer[]	No
`cc_emails`	string[]	No
`bcc_emails`	string[]	No
`is_broadcast`	boolean	No	Default: `False`.
`external_id`	string	No
`external_source_type`	object	No
`email_content`	string	No
`event_created_at`	string (date-time)	No	Event creation timestamp. When provided via public API, also backdates the note’s created time, SLA metrics, and activit
`transition`	object	No	Applied in the same transaction as the note: both commit, or neither does. Takes the same body PATCH /requests/{requestI