Skip to main content
POST
/
v0
/
chat
/
{conversation_id}
/
escalate
Escalate to ticketing integration
curl --request POST \
  --url https://api.getdecimal.ai/v0/chat/{conversation_id}/escalate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration": "plain",
  "email": "jsmith@example.com",
  "name": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "additional_fields": {
    "label_type_ids": [
      "<string>"
    ],
    "priority": 123
  }
}
'
{
  "success": true,
  "integration": "plain",
  "ticket_id": "<string>",
  "ticket_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

API token with sk-de- prefix. Created in the Decimal dashboard under Settings → API Tokens.

Path Parameters

​
conversation_id
string
required

Conversation ID (returned by POST /v0/chat).

Body

application/json
​
integration
enum<string>
required
Available options:
plain
​
email
string<email>
required

Customer email for the ticket.

Minimum string length: 1
​
name
string
required

Customer name for the ticket.

Minimum string length: 1
​
title
string

Ticket title. Auto-generated from conversation if omitted.

​
summary
string

Ticket summary. Auto-generated from conversation if omitted.

​
additional_fields
object

Response

Escalation successful.

​
success
enum<boolean>
required
Available options:
true
​
integration
enum<string>
required
Available options:
plain,
pylon,
linear
​
ticket_id
string

External ticket ID in the integration.

​
ticket_url
string<uri>

URL to the ticket in the integration (not available for all integrations).