Skip to main content
GET
List Ticket Messages

Authentication and permissions

Token requirements: User-based token (OAuth) or Organization-scoped API key or Workspace-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Workspace keys must allow every workspace checked by the request. OAuth access depends on the user’s roles and resource access.
  • Workspace messages: Internal notes require permission to view internal notes on the owning workspace.
  • Requester messages: You must be the ticket’s requester. Not available for system-created tickets or tickets restricted to their workspace. Internal notes are not returned.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

ticket_id
string
required

The UUID of the ticket to list messages for. Ticket keys such as "IT-123" are not accepted.

Query Parameters

pageSize
integer<int32>

Maximum number of results to return.

pageToken
string

Token for pagination.

Response

200 - application/json

Success

data
Message · object[]
nextPageToken
string | null