Sign in

v3

latestOpenAPI 3.0.32026-07-31135300306.1 KB
messages

Create an internal note on an issue

Posts an internal note on an issue thread. Not visible to the requester.

Thread selection:

  • If thread_id is provided, posts to that internal thread.

  • If message_id is provided, posts to the thread containing that internal note.

  • Providing both thread_id and message_id returns a 400 response.

  • If neither is provided, posts to the most recently created Slack-backed internal thread. If none exists, creates a Pylon-only internal thread.

  • thread_name names that newly created Pylon-only thread and is otherwise ignored.

Empty thread_id, message_id, and thread_name values are treated as omitted.

Rate limit: 10 requests per minute

post/issues/{id}/note

Path parameters

idstring required

The ID of the issue.

Request body

attachment_urlsstring[]

URLs of files to attach to this internal note.

body_htmlstring required

The body of the message in HTML.

message_idstring

The ID of an internal note whose thread should receive the new note. Use the top-level id from GET /issues/{id}/messages. Cannot be combined with thread_id.

thread_idstring

The ID of the internal thread to post the note to. Use the id field (not thread_id) from GET /issues/{id}/threads. Cannot be combined with message_id.

thread_namestring

Optional name for a new Pylon-only internal thread. Used only when neither thread_id nor message_id is provided and no Slack-backed internal thread exists.

user_idstring

Optional user ID to post the message as. If not provided, the API token user will be used.

Response

request_idstring

The request ID for tracking.