Escalation destination

Get the destination of the escalated cases

GET

https://api.lelemon.cl

/v2/escalation-destination

Bearer (API key)

Where the cases escalated to the technical team go: a Linear team or a webhook URL. It also returns the callback URL where the other tool reports the answer. API keys and signing secrets are never returned. 404 when no destination is connected. Read only and safe to repeat.

Required scope: escalation-destination:read.

Get the destination of the escalated cases › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Get the destination of the escalated cases › Responses

EscalationDestination

object

string · enum · required

Enum values:

escalation_destination

id

string · required

provider

string · enum · required

Enum values:

linear

webhook

required

EscalationCallback · required

required

The secrets Lelemon generated in this call. They are shown once, here, and never again: save them now. null when nothing new was generated, and always null on reads.

createdAt

string · date-time · required

updatedAt

string · date-time · required

GET/v2/escalation-destination

curl https://api.lelemon.cl/v2/escalation-destination \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "object": "escalation_destination",
  "id": "esd_5RvP2aKq9XwLmN3tYbZc01",
  "provider": "linear",
  "linear": {
    "teamId": "team-uuid",
    "teamKey": "LEL",
    "teamName": "Lelemon",
    "projectId": "projectId"
  },
  "webhook": {
    "url": "https://n8n.example.com/webhook/escalations"
  },
  "callback": {
    "url": "https://api.lelemon.cl/webhooks/escalation/esd_5RvP2aKq9XwLmN3tYbZc01",
    "registration": "automatic",
    "secretConfigured": true
  },
  "secrets": {
    "signingSecret": "signingSecret",
    "callbackSecret": "callbackSecret"
  },
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Connect the destination of the escalated cases

PUT

https://api.lelemon.cl

/v2/escalation-destination

Bearer (API key)

One destination per organization; connecting again replaces it. With provider linear, Lelemon checks the API key and the team with Linear, creates the webhook in Linear by itself (resource Issue, that team, signing secret generated by Lelemon) and deletes the one it created before when the team changes. If the key belongs to someone who cannot create webhooks in Linear, the destination is saved anyway with callback.registration manual: register callback.url in Linear and send its signing secret in linear.webhookSecret. With provider webhook, Lelemon posts a signed JSON to your https URL for each escalation and generates two secrets, returned once in secrets: one signs what Lelemon sends, the other signs what your tool sends back to callback.url. Changing from one provider to another deletes the Linear webhook Lelemon had created. 422 escalation_destination_rejected when the data is not accepted; 503 when Linear does not answer. Safe to repeat.

Required scope: escalation-destination:write.

Connect the destination of the escalated cases › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Connect the destination of the escalated cases › Request Body

ConnectEscalationDestination

provider

string · enum · required

linear: Lelemon creates the task in Linear and registers the webhook there. webhook: Lelemon posts a signed JSON to your URL, which covers Jira, Trello, n8n, Zapier or any tool.

Enum values:

linear

webhook

object

Required when provider is linear.

object

Required when provider is webhook.

Connect the destination of the escalated cases › Responses

EscalationDestination

object

string · enum · required

Enum values:

escalation_destination

id

string · required

provider

string · enum · required

Enum values:

linear

webhook

required

EscalationCallback · required

required

The secrets Lelemon generated in this call. They are shown once, here, and never again: save them now. null when nothing new was generated, and always null on reads.

createdAt

string · date-time · required

updatedAt

string · date-time · required

PUT/v2/escalation-destination

curl https://api.lelemon.cl/v2/escalation-destination \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "provider": "linear",
  "linear": {
    "apiKey": "lin_api_xxxxxxxxxxxxxxxx",
    "team": "LEL"
  }
}'

Example Request Body

{
  "provider": "linear",
  "linear": {
    "apiKey": "lin_api_xxxxxxxxxxxxxxxx",
    "team": "LEL"
  }
}

json

application/json

Example Responses

{
  "object": "escalation_destination",
  "id": "esd_5RvP2aKq9XwLmN3tYbZc01",
  "provider": "linear",
  "linear": {
    "teamId": "team-uuid",
    "teamKey": "LEL",
    "teamName": "Lelemon",
    "projectId": "projectId"
  },
  "webhook": {
    "url": "https://n8n.example.com/webhook/escalations"
  },
  "callback": {
    "url": "https://api.lelemon.cl/webhooks/escalation/esd_5RvP2aKq9XwLmN3tYbZc01",
    "registration": "automatic",
    "secretConfigured": true
  },
  "secrets": {
    "signingSecret": "signingSecret",
    "callbackSecret": "callbackSecret"
  },
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Disconnect the destination of the escalated cases

DELETE

https://api.lelemon.cl

/v2/escalation-destination

Bearer (API key)

Deletes the destination with its keys and secrets, deletes the webhook Lelemon created in Linear, and stops accepting callbacks. The tasks already created stay in the other tool and the escalations stay in the cases. 503 when Linear does not answer, and then nothing is deleted so you can repeat the call. Repeating the call after it worked returns 404.

Required scope: escalation-destination:write.

Disconnect the destination of the escalated cases › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Disconnect the destination of the escalated cases › Responses

No data returned

List the Linear teams and projects a key can see

POST

https://api.lelemon.cl

/v2/escalation-destination/linear-options

Bearer (API key)

Use it before connecting Linear to choose the team and the project. The key is used once and not stored. 422 escalation_destination_rejected when Linear does not accept the key; 503 when Linear does not answer. Read only and safe to repeat.

Required scope: escalation-destination:write.

List the Linear teams and projects a key can see › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Idempotency-Key

string · minLength: 1 · maxLength: 255

Makes the request safe to retry. Once it starts running, its final response (2xx, 4xx or 5xx) is kept for 24 hours and the same key gets it back, without repeating the effect. A request rejected before it runs leaves the key free. A replayed create omits the secret. The same key with a different request is rejected with 409 idempotency_key_reused.

List the Linear teams and projects a key can see › Request Body

LinearOptionsRequest

apiKey

string · minLength: 8 · maxLength: 255 · pattern: ^\S+$ · required

A Linear personal API key. It is used once and not stored.

List the Linear teams and projects a key can see › Responses

LinearOptions

object

string · enum · required

Enum values:

linear_options

LinearTeamOption[] · required

List the latest escalations of the organization

GET

https://api.lelemon.cl

/v2/escalation-destination/escalations

Bearer (API key)

The escalations of all the cases to the technical team, newest first, with their status and the task in the other tool. Read only and safe to repeat.

Required scope: escalation-destination:read.

List the latest escalations of the organization › query Parameters

limit

integer · min: 1 · max: 100

Default: 20

cursor

string · maxLength: 512

The nextCursor of the previous page, with the same filters.

List the latest escalations of the organization › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

List the latest escalations of the organization › Responses

TeamEscalationList

object

string · enum · required

Enum values:

list

hasMore

boolean · required

nextCursor

string | null · required

TeamEscalation[] · required

GET/v2/escalation-destination/escalations

curl https://api.lelemon.cl/v2/escalation-destination/escalations \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "object": "list",
  "hasMore": true,
  "nextCursor": "nextCursor",
  "data": [
    {
      "object": "team_escalation",
      "id": "esc_5RvP2aKq9XwLmN3tYbZc01",
      "caseId": "cse_5RvP2aKq9XwLmN3tYbZc01",
      "provider": "linear",
      "status": "pending",
      "origin": "stage",
      "task": {
        "reference": "LEL-123",
        "url": "https://linear.app/lelemon/issue/LEL-123"
      },
      "answerStageId": "answerStageId",
      "answer": "answer",
      "lastError": "lastError",
      "completedAt": "2024-08-25T15:00:00Z",
      "createdAt": "2024-08-25T15:00:00Z"
    }
  ]
}

json

application/json

Teams