List Ticket External Messages

GET

tickets

{ticket_id}

external-messages

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

{
  "data": [
    {
      "id": "<string>",
      "externalMessageId": "<string>",
      "messageId": "<string>",
      "sourceType": "EXTERNAL_MESSAGE_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 messages for

Response

Success

data

ExternalMessage · object[]

Show child attributes

data.id

string

The ID of the external message in Serval's system

data.externalMessageId

string

The ID of the external message in the external system

data.messageId

string

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

data.sourceType

enum<string>

The type of external system (Slack, Jira, Email, etc.)

Available options:

EXTERNAL_MESSAGE_SOURCE_TYPE_UNSPECIFIED,

EXTERNAL_MESSAGE_SOURCE_TYPE_SLACK,

EXTERNAL_MESSAGE_SOURCE_TYPE_LINEAR,

EXTERNAL_MESSAGE_SOURCE_TYPE_EMAIL,

EXTERNAL_MESSAGE_SOURCE_TYPE_JIRA,

EXTERNAL_MESSAGE_SOURCE_TYPE_PUBLIC_API,

EXTERNAL_MESSAGE_SOURCE_TYPE_FRESHSERVICE,

EXTERNAL_MESSAGE_SOURCE_TYPE_ZENDESK,

EXTERNAL_MESSAGE_SOURCE_TYPE_SERVICENOW,

EXTERNAL_MESSAGE_SOURCE_TYPE_PHONE_CALL,

EXTERNAL_MESSAGE_SOURCE_TYPE_MICROSOFT

data.sourceId

string

The ID of the source/integration in Serval

data.isOrigin

boolean

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

data.createdAt

string<date-time>

Timestamp when the external message link was created

data.updatedAt

string<date-time>

Timestamp when the external message link was last updated

List Audit LogsList audit logs for your organization. You can optionally filter by time range.

⌘I

List Ticket External Messages

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

{
  "data": [
    {
      "id": "<string>",
      "externalMessageId": "<string>",
      "messageId": "<string>",
      "sourceType": "EXTERNAL_MESSAGE_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