List Ticket External Tickets

GET

tickets

{ticket_id}

external-tickets

curl --request GET \
  --url https://public.api.serval.com/v2/tickets/{ticket_id}/external-tickets \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "externalTicketId": "<string>",
      "ticketId": "<string>",
      "sourceType": "EXTERNAL_TICKET_SOURCE_TYPE_UNSPECIFIED",
      "sourceId": "<string>",
      "isOrigin": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

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 ID of the Serval ticket to list external tickets for

Response

Success

data

ExternalTicket · object[]

Show child attributes

data.id

string

The ID of the external ticket in Serval's system

data.externalTicketId

string

The ID of the external ticket in the external system (e.g., "PROJ-123" for Jira)

data.ticketId

string

The ID of the Serval ticket this external ticket is linked to

data.sourceType

enum<string>

The type of external system (Jira, Linear, ServiceNow, etc.)

Available options:

EXTERNAL_TICKET_SOURCE_TYPE_UNSPECIFIED,

EXTERNAL_TICKET_SOURCE_TYPE_LINEAR,

EXTERNAL_TICKET_SOURCE_TYPE_JIRA,

EXTERNAL_TICKET_SOURCE_TYPE_EMAIL,

EXTERNAL_TICKET_SOURCE_TYPE_CSV_IMPORT,

EXTERNAL_TICKET_SOURCE_TYPE_PUBLIC_API,

EXTERNAL_TICKET_SOURCE_TYPE_FRESHSERVICE,

EXTERNAL_TICKET_SOURCE_TYPE_SLACK,

EXTERNAL_TICKET_SOURCE_TYPE_ZENDESK,

EXTERNAL_TICKET_SOURCE_TYPE_SERVICENOW,

EXTERNAL_TICKET_SOURCE_TYPE_PHONE_CALL,

EXTERNAL_TICKET_SOURCE_TYPE_MICROSOFT

data.sourceId

string

The ID of the source/integration in Serval (connected service ID)

data.isOrigin

boolean

Whether this external ticket is the origin source of the Serval ticket True if the Serval ticket was created from this external ticket

data.createdAt

string<date-time>

Timestamp when the external ticket link was created

data.updatedAt

string<date-time>

Timestamp when the external ticket link was last updated

List Ticket External MessagesList all origin external messages for a ticket. These are messages that originated from external systems and were synced into Serval. This helps you understand which messages came from which external channels.

⌘I

List Ticket External Tickets

curl --request GET \
  --url https://public.api.serval.com/v2/tickets/{ticket_id}/external-tickets \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "externalTicketId": "<string>",
      "ticketId": "<string>",
      "sourceType": "EXTERNAL_TICKET_SOURCE_TYPE_UNSPECIFIED",
      "sourceId": "<string>",
      "isOrigin": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authentication

Endpoints

Development

Authorizations

Path Parameters

Response