> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Escalating threads

<Snippet file="graphql/sdk-note.mdx" />

An [escalation path](https://plain.support.site/article/escalation-paths) is a configured sequence of users or label-type owners that a thread escalates through when no-one is responding in time. Escalation paths themselves are configured in the Plain app under **Settings → Escalation paths**.

The API lets you trigger an escalation programmatically and change which escalation path a thread is on.

These operations require the following permissions:

* `thread:edit`

## Escalate a thread

`escalateThread` advances the thread to the next step in its current escalation path. If the thread doesn't have an escalation path attached, the call returns an error.

<Snippet file="graphql/escalate-thread.mdx" />

## Change the escalation path

Attach a thread to a specific escalation path (or pass `escalationPathId: null` to detach it).

<Snippet file="graphql/update-thread-escalation-path.mdx" />