messages

Create or update a draft reply

Changed on

Creates a private customer-reply draft without sending it. The draft is visible only to its owner and may require a normal issue refetch before appearing in the app. For unlinked or service API tokens, user_id is required. This endpoint updates only untouched drafts that it previously created; every other existing draft returns a conflict.

Rate limit: 30 requests per minute

post/issues/{id}/draft-reply

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/issues/{id}/draft-reply
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the issue.

Request body

bcc_emailsstring[]

The draft's BCC recipients. See to_emails.

body_htmlstring required

The draft body in HTML.

cc_emailsstring[]

The draft's CC recipients. See to_emails.

to_emailsstring[]

The draft's To recipients. If any of to_emails, cc_emails, or bcc_emails is provided, the draft uses exactly those lists and an omitted list is saved empty; omit all three to use the composer's default recipients.

user_idstring

The active Pylon user who should own and see the draft. Defaults to the API-token user when it is a human Pylon user; required for unlinked or service API tokens.

Response

request_idstring required

The request ID for tracking.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • breaking

      the response's property type changed from no type to object for status

    • info

      removed from the response property allOf list for the response status

    • info

      the response property became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status