Authentication
Endpoints
- GETList Tickets
- POSTCreate Ticket
- GETGet Ticket
- PUTUpdate Ticket
- GETList Labels
- GETList Statuses
- GETList Priorities
- GETList Ticket Subscribers
- POSTCreate Ticket Subscribers
- DELDelete Ticket Subscriber
- POSTSync Ticket to Channel
- POSTConnect to External Ticket
- DELDisconnect from External Ticket
- GETList Ticket External Tickets
- GETList Ticket External Messages
- GET
Development
Get Ticket
Get a specific ticket by ID.
curl --request GET \
--url https://public.api.serval.com/v2/tickets/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "<string>",
"friendlyIdentifier": "<string>",
"teamId": "<string>",
"name": "<string>",
"description": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"escalatedAt": "2023-11-07T05:31:56Z",
"createdByUserId": "<string>",
"assignedToUserId": "<string>",
"requesterUserId": "<string>",
"statusId": "<string>",
"escalationLevel": "AI",
"priorityId": "<string>",
"slaStartedAt": "2023-11-07T05:31:56Z",
"slaBreachesAt": "2023-11-07T05:31:56Z",
"labelIds": [
"<string>"
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Success
Show child attributes
Show child attributes
The ID of the Serval ticket.
A friendly identifier for the ticket. This is a unique identifier for the ticket that is displayed to the user. It is a combination of the team prefix (configured in Settings > Organization Settings > Teams) and the ticket number. Example: For the Acme team's 10th ticket, the friendly identifier is "ACM-10".
The ID of the team that the ticket belongs to.
A name or title for the ticket.
A description of the ticket.
Timestamp indicating when the ticket was created. Will be in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
Timestamp indicating when the ticket was completed. Will be in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
Timestamp indicating when the ticket was escalated. Will be in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
The ID of the user who created the ticket.
The ID of the user who is assigned to the ticket. Optional if the ticket is not assigned to a user.
The ID of the user this ticket was created on behalf of (the requester).
The ID of the status option for the ticket.
The escalation level of the ticket.
AI, HUMAN The ID of the priority option for the ticket.
Timestamp indicating when the SLA started. Will be in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
Timestamp indicating when the SLA was breached. Will be in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
List of label IDs for the ticket.
Was this page helpful?
curl --request GET \
--url https://public.api.serval.com/v2/tickets/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "<string>",
"friendlyIdentifier": "<string>",
"teamId": "<string>",
"name": "<string>",
"description": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"escalatedAt": "2023-11-07T05:31:56Z",
"createdByUserId": "<string>",
"assignedToUserId": "<string>",
"requesterUserId": "<string>",
"statusId": "<string>",
"escalationLevel": "AI",
"priorityId": "<string>",
"slaStartedAt": "2023-11-07T05:31:56Z",
"slaBreachesAt": "2023-11-07T05:31:56Z",
"labelIds": [
"<string>"
]
}
}