Get my support ticket
Returns one support ticket and its complete conversation only when the acting PAT/OAuth user is the ticket opener. A ticket belonging to another user is reported as not found.
GET
/support/tickets/{ticketId}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredPath parameters
ticketIdstringrequiredSupport ticket UUID.
Responses
200Ticket details and complete conversation.
createdAtstring<date-time>requiredWhen the ticket was opened.
idstringrequiredSupport ticket UUID.
lastMessageAtstring<date-time>requiredWhen the newest message was created.
lastMessageAuthorSidestringrequiredWhich side wrote the newest message.
Allowed:
UserAdminlastMessageTextBodystringrequiredPlain-text preview of the newest message.
messagesSupportMessageDto[]requiredComplete conversation ordered from oldest to newest.
Show propertiesHide properties
Array of
SupportMessageDtoauthorSidestringrequiredWhether the opener or the Leadtime team wrote the message.
Allowed:
UserAdminauthorUserIdobject | nullrequiredThe ticket opener user UUID for opener-authored messages. Null for Leadtime team messages.
bodystringrequiredMessage body rendered as HTML.
createdAtstring<date-time>requiredWhen the message was created.
idstringrequiredSupport message UUID.
manageAuthorobject | nullrequiredName and avatar of the Leadtime team member for team-authored messages. Never contains an email address.
Show propertiesHide properties
avatarobject | nullrequiredAvatar configuration for the Leadtime team member. Null when no avatar is configured.
Show propertiesHide properties
idstringrequiredStable avatar configuration identifier.
kindstringrequiredHow the support team member avatar is rendered.
Allowed:
generateduploadedleadtimeAgentoptionsobjectGenerated-avatar rendering options.
stylestringGenerated-avatar style when kind is generated.
Allowed:
adventurerbotttsinitialspersonasnotionistsdylanbottts-neutralnamestringrequiredDisplay name of the Leadtime team member.
textBodystringrequiredPlain-text message body for summaries and search.
statusstringrequiredCurrent ticket status.
Allowed:
OpenClosedtitlestringrequiredGenerated ticket title, or the immediate first-message fallback while generation is running.
titleIsGeneratingbooleanrequiredWhether a generated title is still being prepared.
unreadbooleanrequiredWhether the acting opener has an unread message from the Leadtime team.
userLastSeenAtobject<date-time> | nullrequiredWhen the ticket opener last viewed the conversation.
400The ticket identifier is not a valid UUID.
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
404Ticket not found for the acting user.
Request
curl -X GET "https://leadtime.app/api/public/support/tickets/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/support/tickets/string", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/support/tickets/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"createdAt": "2019-08-24T14:15:22Z",
"id": "5532b85e-bef7-48c9-9272-9de7c63a1234",
"lastMessageAt": "2019-08-24T14:15:22Z",
"lastMessageAuthorSide": "User",
"lastMessageTextBody": "The project page stays blank after I select it.",
"messages": [
{
"authorSide": "User",
"authorUserId": "65bc3ac7-d43b-43c9-b3f2-4bd3b46c96bc",
"body": "<p>The project page stays blank after I select it.</p>",
"createdAt": "2019-08-24T14:15:22Z",
"id": "81008f98-5921-4acb-936b-62d122d1fcfd",
"manageAuthor": {
"avatar": {
"id": "9c26ca8f-fc9a-40fc-b5e0-ec0aa344f6fd",
"kind": "generated",
"options": {},
"style": "adventurer"
},
"name": "Alex Morgan"
},
"textBody": "The project page stays blank after I select it."
}
],
"status": "Open",
"title": "Project page stays blank",
"titleIsGenerating": true,
"unread": true,
"userLastSeenAt": {}
}The ticket identifier is not a valid UUID.
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions
Ticket not found for the acting user.