Comment on a ticket

Post to a work item’s thread. In the console, anyone on the project can comment — seeing the work is enough to talk about it. Write `<@employeeId>` to mention someone: they get a direct message in Threads linking back to the ticket, plus a notification, and everyone else following it hears about the comment.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Dev Tools → API, to an assistant or CLI sign-in when you approve or edit it under Dev Tools, and to a teammate under Employee → Permissions.

projects:write

Path Parameters

Name	Type	Required	Description
`ticketId`	string	Required	Ticket ID.

Request Body

Property	Type	Required	Description
`body`	string	Required	The comment. Mention someone with `<@employeeId>`.

POSTExample request

curl

curl -X POST "https://www.pxb.app/api/public/v1/tickets/{ticketId}/comments" \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Blocked on the tax categories — <@emp_44f1> can you confirm?"
  }'

200Example response

json

{
  "message": "Comment posted successfully!",
  "content": {
    "commentId": "cmt_88aa"
  }
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Projects

/projects

Open a ticket.
Write in the comment composer.