Link Thread External Ticket

Attach an external ticket reference authorized by your backend.

Requires conversations:write. The integration must verify the association before calling: this endpoint needs no end-user JWT and makes no external API calls. Further updates use the configured connector’s standard sync.

POST /api/v1/conversations/{thread_id}/external-ticket

Link Thread External Ticket

cURL

curl --request POST \
  --url https://{tenant_id}.api.useago.com/api/v1/conversations/{thread_id}/external-ticket \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ticketing_system": "<string>",
  "external_id": "<string>"
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ticketing_system": "<string>",
  "external_id": "<string>",
  "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "ticket"
}

Authorizations

X-API-Key · string · header · required

Path Parameters

thread_id · string<uuid> · required

Body

application/json

ticketing_system · string · required

Pattern: ^[a-z][a-z0-9_-]{0,63}$

external_id · string · required

Required string length: 1 - 255

Response

200 - application/json

OK

id · string<uuid> · required

ticketing_system · string · required

external_id · string · required

conversation_id · string<uuid> · required

object · string · default: ticket