Skip to main content
GET
/
v1
/
helpdesk-tickets
/
{id}
Get helpdesk ticket by id
curl --request GET \
  --url https://api.conduit.ai/v1/helpdesk-tickets/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "hd77c0dy0mgdpzmqz6tesry8w184002s",
    "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
    "contact_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
    "ticket_id": "tk77c0dy0mgdpzmqz6tesry8w184002s",
    "connection_id": "cn77c0dy0mgdpzmqz6tesry8w184002s",
    "external_ticket_id": "zd_12345",
    "external_group_id": "grp_42",
    "external_assignee_id": "usr_987",
    "subject": "Unable to access door code",
    "description": "Guest reports the keypad is not accepting the code.",
    "status": "open",
    "priority": "high",
    "type": "incident",
    "channel": "email",
    "tags": [
      "urgent",
      "access"
    ],
    "requester": {
      "external_id": "zd_user_abc",
      "name": "Taylor Reid",
      "email": "taylor.reid@example.com"
    },
    "last_external_update_at": "2026-04-19T14:05:00.000Z",
    "created_at": "2026-04-19T13:48:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

Helpdesk ticket id.

Example:

"hd77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

Optional workspace override. If omitted, Conduit resolves the helpdesk ticket's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Response

Helpdesk ticket

Single helpdesk ticket response including requester identity and upstream metadata.

​
data
object
required

A helpdesk ticket mirrored from an external helpdesk system (Zendesk, Pylon, Plain). external_ticket_id is the upstream ticket id; id is the Conduit-stable identifier.