Support
Support covers the Help assistant's conversations and the tickets they raise. Open conversations, file and follow tickets, comment, attach files and link tickets to tasks.
List conversations
Lists up to 100 of the current user's support chat conversations, newest first. Naming another user's `user_id` is limited to Jaah support staff and returns 403 otherwise.
Create conversation
Opens a new support chat conversation for the current user and returns its ID. Rate limited per user.
Get conversation
Returns a support chat conversation with its messages, oldest first, and any ticket filed from it. Only its owner and Jaah support staff can read it; anyone else gets 404.
Create chat attachment ticket
Registers a pending file on the caller's own chat conversation and returns a presigned upload URL for its bytes; confirm the upload afterwards. A chat holds at most 50 files, after which this returns 409.
Confirm chat attachment
Confirms that an uploaded chat file's bytes arrived, so the file can be attached to a message. Only the uploader can confirm. Returns the file.
Get chat attachment content
Redirects (307) to a presigned download URL for a chat file. Open to anyone who can read the conversation.
Send message
Sends a message, with optional confirmed files, to the support assistant and streams the reply as server-sent events. Refusals such as 404, 409, 413, 429, or 503 when the assistant is busy, return before the stream opens.
List tickets
Lists support tickets one page at a time with `cursor`; `limit` is at most 200. `scope` is `mine`, `org` (Org Owner or Org Admin only) or `all` (Jaah support staff only); repeat `status` or `priority` to filter, and sort by `updated`, `age` or `priority`.
Create ticket
Creates a support ticket, optionally from one of the caller's chat conversations, which then links to it; a conversation that already has a ticket returns 409. Secret-like values in the title, description and page URL are redacted before storage. Returns the ticket.
Get ticket
Returns one support ticket with its status, priority and linked tasks. Visible to its requester, the Org Owners and Org Admins of its organization, and Jaah support staff; anyone else gets 404.
Update ticket
Changes a ticket's status, priority, or both; only Jaah support staff set priority. A status the caller may never set returns 403, and an illegal move from the current status returns 409. Returns the ticket.
List ticket attachments
Lists a ticket's uploaded files, oldest first. Internal files appear only to Jaah support staff.
Create ticket attachment ticket
Registers a pending file on a ticket and returns a presigned upload URL for its bytes; confirm the upload afterwards. Uploading follows the comment rules: internal files are staff-only, and a customer cannot add files to a closed ticket.
Delete ticket attachment
Deletes a file from a ticket, along with its stored bytes once nothing else uses them. Uploaders can delete their own files; Jaah support staff can delete any. Returns 204 with no body.
Confirm ticket attachment
Confirms that an uploaded ticket file's bytes arrived, making the file visible on the ticket. Only the uploader or Jaah support staff can confirm. Returns the file.
Get ticket attachment content
Redirects (307) to a presigned download URL for a ticket file. Internal files are readable only by Jaah support staff.
List ticket comments
Lists a ticket's most recent comments, up to `limit` (default 200, at most 500), oldest first. Internal notes appear only to Jaah support staff.
Create ticket comment
Posts a public reply to a ticket, or an internal note (Jaah support staff only), and notifies anyone it @mentions. A reply updates the ticket's activity and can move its status; a customer's reply on a closed ticket returns 409. Returns the comment.
Delete ticket comment
Deletes a ticket comment and its mentions. Authors can delete their own; Jaah support staff can delete any, and only staff can delete on a closed ticket. Returns 204 with no body.
Update ticket comment
Edits a ticket comment's text and notifies anyone newly @mentioned. Only the author can edit, and a customer cannot edit on a closed ticket. Returns the comment.
Remove ticket reaction
Removes the caller's own emoji reaction from a ticket comment. Idempotent. Returns the comment.
Add ticket reaction
Adds the caller's emoji reaction to a ticket comment and notifies the comment's author the first time. Idempotent. Returns the comment.
Link ticket task
Links an existing task to a ticket; Jaah support staff only. A task already done is linked as acknowledged, and a task already linked returns 409. Returns the link.
Unlink ticket task
Removes a task link from a ticket without changing the task. Jaah support staff only. Returns 204 with no body.
List ticket mention candidates
Lists the people a comment of the given `visibility` on this ticket can @mention, the same set a posted comment resolves mentions against. The `internal` list is limited to Jaah support staff.
Mark ticket read
Marks the ticket read for the current user, clearing its unread marker for them. Returns 204 with no body.
Create ticket task
Creates a `draft` task in a project from a ticket, with the given body and `persona`, and links it to the ticket. Limited to Jaah support staff who may create tasks. Returns the new task ID and the link.