API reference

Support escalations

Support threads handed to Monotree because they need a fix or an answer from Monotree.

Base URL https://partners.monotree.com/api/v1 · every call needs a token

Escalate a thread to Monotree

post /support/threads/{thread}/escalations support:write

Hands what the thread is about on to Monotree, your second line: a bug, a feature request, or an investigation into a customer's data. Monotree picks it up and says how it stands (status). Where the same thing was escalated already, send only duplicate_of and the thread is added to that escalation; nothing new goes to Monotree (Find similar escalations shows candidates). The thread must belong to a customer, and keeps its status. Sends support.escalation.created, or support.escalation.updated for a duplicate. In the sandbox nothing reaches Monotree and the escalation stays sent.

Parameters

thread required

string · path

The thread's ID.

Accepts an optional Idempotency-Key header to make a retry safe.

Request body

title

string

Needed unless duplicate_of is sent.

at least 3 characters · at most 120 characters

category

string

Needed unless duplicate_of is sent.

one of bug, feature_request, investigation

description

string, nullable

What happens, where, and how to see it.

at most 10000 characters

tags

array of integers

Ids of tags, from List support tags. Here only ids are read, not names; an id that is no tag is left out.

duplicate_of

string

An escalation already sent: the thread is added to it and nothing new goes to Monotree. The other fields are then not read.

at most 40 characters

Response · 201 The escalation: the new one, or the one the thread was added to.

id

string

object

string

category

string

A fault, a wish, or a look into a customer's data.

one of bug, feature_request, investigation

title

string

description

string, nullable

tags

array of strings

Names of the tags it was sent with.

status

string

sent: waiting for Monotree to pick it up. received: Monotree has it. fixed: fixed, not yet shipped. released: it has shipped; follow up on its threads. declined: Monotree will not do it. Every change of status sends support.escalation.updated.

one of sent, received, fixed, released, declined

released_in

string, nullable

The release it shipped in, as Monotree names it.

customer

object, nullable

The customer the person belongs to. Null for a mail from a sender nobody has tied to a customer yet (live only).

id

string

company_name

string

external_ref

string, nullable

Your own reference for the customer.

threads

array of objects

The threads it came from: the one it was made from, and those added to it.

created_at

string, nullable

fixed_at

string, nullable

released_at

string, nullable

Errors

400 invalid_idempotency_key: the Idempotency-Key is longer than 255 characters.
401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no such support thread, or no such escalation of yours (duplicate_of).
409 invalid_state: the thread has no customer yet; tie its sender to one first. idempotency_in_progress: a call with the same Idempotency-Key is still running.
422 validation_error: without duplicate_of, title (3 to 120 characters) and category are needed. idempotency_key_reused: the Idempotency-Key was used for a different request.
429 rate_limited: more than 20 escalations in an hour (all your tokens of one mode together), or over the general limit. Wait for the number of seconds in Retry-After.
curl -X POST https://partners.monotree.com/api/v1/support/threads/sth_01m7d1ajq9w7ak2vnnp8hfdwj8/escalations \
  -H "Authorization: Bearer $MONOTREE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Invitation link opens a blank page",
    "category": "bug",
    "description": "On Android 14 the link in the invitation mail opens a blank page.",
    "tags": [
        1
    ]
}'
201 · Response
{
    "id": "esc_01m7d1cbwj6agthjesfk7198t7",
    "object": "support_escalation",
    "category": "bug",
    "title": "Invitation link opens a blank page",
    "description": "On Android 14 the link in the invitation mail opens a blank page.",
    "tags": [
        "Invitations"
    ],
    "status": "sent",
    "released_in": null,
    "customer": {
        "id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
        "company_name": "Boulangerie Martin",
        "external_ref": "org_48213"
    },
    "threads": [
        {
            "id": "sth_01m7d1ajq9w7ak2vnnp8hfdwj8",
            "relation": "created",
            "follow_up_due": false,
            "followed_up_at": null,
            "follow_up_outcome": null
        }
    ],
    "created_at": "2026-11-14T12:44:09Z",
    "fixed_at": null,
    "released_at": null
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…

                    

Follow up a released escalation

post /support/threads/{thread}/escalations/{escalation}/follow-up support:write

When Monotree releases what was escalated, each thread it came from shows under the followup view until someone says what became of it: told: true where the customer was (or is being) told, false where nobody needs telling. With draft: true the assistant also drafts the message that says it has shipped; it becomes the thread's draft, for you to send. Only a released escalation can be followed up; before that the call answers 409. Following up twice changes nothing.

Parameters

thread required

string · path

The thread's ID.

escalation required

string · path

The escalation's ID.

Accepts an optional Idempotency-Key header to make a retry safe.

Request body

told required

boolean

true: the customer was (or is being) told. false: nobody needs telling.

draft

boolean

Also ask the assistant to draft the message that tells the customer.

default false

Response · 200 The thread whole.

id

string

object

string

channel

string

chat: their Support room in the Monotree app. email: mail to your support address.

one of chat, email

status

string

open waits for you, waiting waits for the customer. closed is done; dismissed was never one to answer (spam, a mistake, an automatic mail).

one of open, waiting, closed, dismissed

view

string

Where the Support page shows it: the status, or snoozed for an open or waiting thread put aside until snoozed_until. Never followup: a thread under that view keeps its own view here.

one of open, waiting, snoozed, closed, dismissed

priority

string

How pressing it is. normal until the assistant reads the thread or you set it; what you set stays.

one of urgent, high, normal, low

kind

string, nullable

What the thread is. The assistant sets it when it reads the thread; what you set stays. Null until then.

one of question, bug, feature_request, other

subject

string, nullable

The subject of a mail. Null for a chat.

summary

string, nullable

What it is about, in a line, as the assistant read it.

preview

string, nullable

The start of their last message, up to 190 characters.

language

string, nullable

The language they write in, as the assistant read it.

unread

boolean

The thread is open and they have written since it was last marked read: by one of your people opening it in the portal, or by you sending unread: false.

customer

object, nullable

The customer the person belongs to. Null for a mail from a sender nobody has tied to a customer yet (live only).

id

string

company_name

string

external_ref

string, nullable

Your own reference for the customer.

person

object

Someone at a customer who wrote to support, or was written to, with what Monotree knows of them.

id

string, nullable

Null in List people for a customer's invited admin who has not written and has not been written to yet: start a thread by mail with their email.

object

string

name

string

email

string, nullable

phone

string, nullable

role

string, nullable

Their role in their company's Monotree.

title

string, nullable

Their job title.

locale

string, nullable

The language of their app.

timezone

string, nullable

departments

array of strings

The names of their departments.

device

object, nullable

The phone they last used the app on, where known.

platform

string, nullable

model

string, nullable

os

string, nullable

app_version

string, nullable

last_active_on

string, nullable

The day they last used the app.

verified

boolean

Monotree knows the sender is who they say.

chat

boolean

They have a Support room in the app and can be written to by chat.

admin

boolean

They are the admin Monotree invited at their company, who can always be written to by mail. Told in List people; false on a thread.

customer

object, nullable

Their company. Filled in List people only; null on a thread, which has its own customer.

id

string

company_name

string

assignee

object, nullable

Which of your people has the thread. Null for nobody. The first of your people to answer in the portal gets it; an answer over the API assigns nobody.

id

string

name

string

tags

array of objects

The product areas the thread is about.

cc

array of objects

Who else gets your answers to a mail. Empty for a chat.

signed

boolean

Whether your answers in this thread end with the first name of the person who wrote them. Follows the desk's signature setting for a chat and is always true for a mail, unless set on the thread.

needs_person

object, nullable

Set where the assistant, with auto on sends, did not send its draft and one of your people must look. Cleared when one of you answers.

since

string

reason

string, nullable

Why, in a sentence for your people.

no_reply_needed

boolean

The assistant read their last message as one that needs no answer (a thank-you, say).

snoozed_until

string, nullable

Until when the thread is put aside. Null when it is not, or when the time has passed.

resolution

string, nullable

How a closed thread ended: answered, no_reply (there was nothing to answer), no_response (they went quiet), outreach (a message of yours to many people, sent from the portal). Null while it is open or waiting.

dismissed_reason

string, nullable

Why it was dismissed: staff (by hand, no reason given), spam, mistake, duplicate, api (over the API, no reason given); or by the desk itself, auto (an automatic mail) or deleted (they took the message back).

rating

string, nullable

Whether your answer helped, as the customer said when the chat was closed.

one of positive, negative

rated_at

string, nullable

reopened_count

integer

How many times it was closed or dismissed and opened again.

message_count

integer

Their messages and yours together, the automatic reply included.

started_at

string, nullable

waiting_since

string, nullable

Since when their oldest unanswered message has waited. Null when nothing waits for you.

first_response_at

string, nullable

When their first message was first answered. The automatic reply does not count.

last_message_at

string, nullable

When the last message was written in it. The list is ordered by this.

closed_at

string, nullable

When it was closed or dismissed.

updated_at

string, nullable

messages

array of objects

Only on a single thread: its latest 50 messages, oldest first.

has_earlier_messages

boolean

Only on a single thread: there are messages before the ones in messages.

notes

array of objects

Only on a single thread: the notes of your people, oldest first.

history

array of objects

Only on a single thread: who did what, when, oldest first.

escalations

array of objects

Only on a single thread: what was handed on to Monotree from it.

draft

object, nullable

A draft of an answer by the assistant. Nothing in it is sent until you send it.

id

string

object

string

status

string

queued and running: the assistant is at it. ready: written. failed: it could not be written; see error. cancelled: given up.

one of queued, running, ready, failed, cancelled

round

integer

Which turn of the customer it answers: 1 for their first message.

version

integer

Which version within the round: 2 after one redraft.

trigger

string

What started it: their first message, a later one, a request for another version, a request for a draft, or the follow-up of a released escalation.

one of new, followup, redraft, manual, release

stale

boolean

They have written again since it was drafted.

body

string, nullable

The answer the assistant proposes. Null while it is being written, and where it proposes no answer.

language

string, nullable

The language of the answer.

summary

string, nullable

What the thread is about, in a line.

kind

string, nullable

What the assistant read the thread as: question, bug, feature_request or other.

no_reply_needed

boolean

The assistant read their last message as one that needs no answer. You can agree and close the thread.

confidence

string, nullable

How sure the assistant is of the draft. Null while it is being written.

one of high, medium, low

recommendation

object, nullable

What the assistant advises you to do. Null while the draft is being written.

action

string

send: send the draft. ask_customer: ask the customer for more. create_ticket: escalate to Monotree. close: close without answering. escalate: hand to Monotree now.

one of send, ask_customer, create_ticket, close, escalate

label

string

The action in words.

text

string

Why.

unverified

array of strings

What it could not check.

questions

array of objects

What the assistant would like to know from you for a better version. Answer by asking for another version with answers.

answers

array of objects

The options picked for this version.

note

string, nullable

What was asked of this version.

escalation

object, nullable

An escalation to Monotree the assistant has written out, for you to send with Escalate a thread. Null where it proposes none.

category

string

bug, feature_request or investigation.

title

string

description

string

tags

array of strings

Names of tags.

sources

array of objects

What the assistant read to write it. The shape of an entry is not settled yet; show it, do not build on it.

error

string, nullable

Why it failed. Null unless status is failed.

outcome

string, nullable

What became of it. Null while it waits for you. sent_unchanged, edited, replaced: it was sent, as written, changed, or mostly rewritten. discarded: put aside. superseded: an answer went out another way, or a draft for their next turn replaced it. no_reply_accepted: the thread was closed on it.

one of sent_unchanged, edited, replaced, discarded, superseded, no_reply_accepted

created_at

string, nullable

finished_at

string, nullable

When the assistant was done with it.

Errors

400 invalid_idempotency_key: the Idempotency-Key is longer than 255 characters.
401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no such support thread, or the escalation is not one of that thread.
409 invalid_state: Monotree has not released the escalation yet. idempotency_in_progress: a call with the same Idempotency-Key is still running.
422 validation_error: told is missing or not a boolean. idempotency_key_reused: the Idempotency-Key was used for a different request.
429 rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl -X POST https://partners.monotree.com/api/v1/support/threads/sth_01m7d1ajq9w7ak2vnnp8hfdwj8/escalations/esc_01m7d1cbwj6agthjesfk7198t7/follow-up \
  -H "Authorization: Bearer $MONOTREE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "told": true,
    "draft": true
}'
200 · Response
{
    "id": "sth_01m7d1ajq9w7ak2vnnp8hfdwj8",
    "object": "support_thread",
    "channel": "chat",
    "status": "waiting",
    "view": "waiting",
    "priority": "high",
    "kind": "bug",
    "subject": null,
    "summary": null,
    "preview": "Bonjour, mon invitation ne marche pas.",
    "language": "fr",
    "unread": false,
    "customer": {
        "id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
        "company_name": "Boulangerie Martin",
        "external_ref": "org_48213"
    },
    "person": {
        "id": "per_132",
        "object": "support_person",
        "name": "Sophie Garnier",
        "email": "sophie@boulangeriemartin.example",
        "phone": null,
        "role": "Manager",
        "title": null,
        "locale": "fr",
        "timezone": null,
        "departments": [],
        "device": null,
        "last_active_on": null,
        "verified": true,
        "chat": true,
        "customer": null
    },
    "assignee": {
        "id": "sel_5",
        "name": "Emma Dubois"
    },
    "tags": [
        {
            "id": 1,
            "name": "Invitations",
            "color": "#0e7490"
        }
    ],
    "cc": [],
    "signed": true,
    "needs_person": null,
    "no_reply_needed": false,
    "snoozed_until": null,
    "resolution": null,
    "dismissed_reason": null,
    "rating": null,
    "rated_at": null,
    "reopened_count": 0,
    "message_count": 2,
    "started_at": "2026-11-14T12:43:10Z",
    "waiting_since": null,
    "first_response_at": "2026-11-14T12:43:21Z",
    "last_message_at": "2026-11-14T12:43:21Z",
    "closed_at": null,
    "updated_at": "2026-11-14T12:44:09Z",
    "messages": [
        {
            "id": "msg_01m7d1ajqgwbvenrpw7gz6xn25",
            "object": "support_message",
            "direction": "in",
            "kind": "message",
            "author": {
                "type": "customer",
                "name": "Sophie Garnier"
            },
            "body": "Bonjour, mon invitation ne marche pas.",
            "edited": false,
            "deleted": false,
            "attachments": [],
            "delivery": null,
            "send_state": null,
            "sent_at": "2026-11-14T12:43:10Z",
            "delivered_at": null
        },
        {
            "id": "msg_01m7d1awpxds8kqrrt6733j0d2",
            "object": "support_message",
            "direction": "out",
            "kind": "message",
            "author": {
                "type": "api",
                "name": "API · Back office, production"
            },
            "body": "Bonjour Sophie, voici le guide.",
            "edited": false,
            "deleted": false,
            "attachments": [
                {
                    "id": "att_2",
                    "name": "guide.pdf",
                    "mime": "application/pdf",
                    "size": 48213,
                    "url": "https://partners.monotree.com/api/v1/support/attachments/att_2"
                }
            ],
            "delivery": {
                "state": "delivered",
                "error": null,
                "delivered_at": "2026-11-14T12:43:21Z"
            },
            "send_state": "sent",
            "sent_at": "2026-11-14T12:43:21Z",
            "delivered_at": "2026-11-14T12:43:21Z"
        }
    ],
    "has_earlier_messages": false,
    "notes": [
        {
            "id": "note_2",
            "object": "support_note",
            "author": {
                "type": "api",
                "name": "API · Back office, production"
            },
            "body": "Called the manager; she will try again on Monday.",
            "created_at": "2026-11-14T12:43:20Z"
        }
    ],
    "history": [
        {
            "type": "opened",
            "by": null,
            "details": null,
            "at": "2026-11-14T12:43:10Z"
        },
        {
            "type": "assigned",
            "by": "API · Back office, production",
            "details": {
                "assignee": "Emma Dubois"
            },
            "at": "2026-11-14T12:44:09Z"
        }
    ],
    "escalations": [
        {
            "id": "esc_01m7d1cbwj6agthjesfk7198t7",
            "title": "Invitation link opens a blank page",
            "category": "bug",
            "status": "sent",
            "relation": "created",
            "released_in": null,
            "follow_up_due": false,
            "followed_up_at": null,
            "follow_up_outcome": null
        }
    ],
    "draft": {
        "id": "drf_227",
        "object": "support_draft",
        "status": "ready",
        "round": 1,
        "version": 1,
        "trigger": "new",
        "stale": false,
        "body": "Bonjour Sophie,\n\nMerci pour votre message.\n\nEssayez d'abord de vous déconnecter puis de vous reconnecter, et vérifiez que l'application Monotree est à jour.",
        "language": "fr",
        "summary": null,
        "kind": "bug",
        "no_reply_needed": false,
        "confidence": "medium",
        "recommendation": {
            "action": "create_ticket",
            "label": "Escalate to Monotree",
            "text": "This sounds like a fault in the app rather than a question. Send the first steps, and escalate it to Monotree if they do not help.",
            "unverified": [
                "Whether it happens on every phone or only one kind."
            ]
        },
        "questions": [],
        "answers": [],
        "note": null,
        "escalation": null,
        "sources": [],
        "error": null,
        "outcome": "superseded",
        "created_at": "2026-11-14T12:43:10Z",
        "finished_at": "2026-11-14T12:43:10Z"
    }
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…

                    

List escalations

get /support/escalations support:read

What you have handed on to Monotree, newest first by when it was escalated, each with the threads it came from. A sandbox token lists the escalations of sandbox customers only.

Parameters

limit

integer · query

How many to return in a page, 1 to 100.

default 25 · up to 100

cursor

string · query

The next_cursor of the page before, for the next page. Send the same filters with it.

status

string · query

sent: waiting for Monotree to pick it up. received: Monotree has it. fixed: fixed, not yet shipped. released: it has shipped. declined: Monotree will not do it.

one of sent, received, fixed, released, declined

category

string · query

What kind of thing it is.

one of bug, feature_request, investigation

customer

string · query

Only those of this customer: its ID, or external_ref: and your own reference.
Response · 200 A page of escalations.

object

string

has_more

boolean

Whether there is a page after this one.

next_cursor

string, nullable

Pass as cursor for the next page.

data

array of objects

Errors

400 invalid_cursor: the cursor is not one this API gave out.
401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no such customer for your company and mode.
422 validation_error: a field is missing or invalid; fields says which.
429 rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/support/escalations \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "object": "list",
    "has_more": false,
    "next_cursor": "string",
    "data": [
        {
            "id": "esc_01m7d1cbwj6agthjesfk7198t7",
            "object": "support_escalation",
            "category": "bug",
            "title": "Invitation link opens a blank page",
            "description": "On Android 14 the link in the invitation mail opens a blank page.",
            "tags": [
                "Invitations"
            ],
            "status": "sent",
            "released_in": null,
            "customer": {
                "id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
                "company_name": "Boulangerie Martin",
                "external_ref": "org_48213"
            },
            "threads": [
                {
                    "id": "sth_01m7d1ajq9w7ak2vnnp8hfdwj8",
                    "relation": "created",
                    "follow_up_due": false,
                    "followed_up_at": null,
                    "follow_up_outcome": null
                }
            ],
            "created_at": "2026-11-14T12:44:09Z",
            "fixed_at": null,
            "released_at": null
        }
    ]
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…

                    

Find similar escalations

get /support/escalations/similar support:read

Escalations of yours that Monotree has not yet released or declined and that share a word of four letters or more with the title and description you are about to send. Those of the category you name come first (bug where you name none), then the newest. At most five, in one answer. Use one as duplicate_of rather than sending the same thing twice.

Parameters

title required

string · query

The title you are about to send.

description

string · query

The description you are about to send. Its first 200 characters are used.

category

string · query

Escalations of this category come first.

one of bug, feature_request, investigation · default bug

Response · 200 Up to five escalations, the likeliest first. Empty where nothing looks alike.

object

string

has_more

boolean

Whether there is a page after this one.

next_cursor

string, nullable

Pass as cursor for the next page.

data

array of objects

Errors

401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
422 validation_error: title is missing, or category is not one of the three.
429 rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/support/escalations/similar \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "object": "list",
    "has_more": false,
    "next_cursor": "string",
    "data": [
        {
            "id": "esc_01m7d1cbwj6agthjesfk7198t7",
            "object": "support_escalation",
            "category": "bug",
            "title": "Invitation link opens a blank page",
            "description": "On Android 14 the link in the invitation mail opens a blank page.",
            "tags": [
                "Invitations"
            ],
            "status": "sent",
            "released_in": null,
            "customer": {
                "id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
                "company_name": "Boulangerie Martin",
                "external_ref": "org_48213"
            },
            "threads": [
                {
                    "id": "sth_01m7d1ajq9w7ak2vnnp8hfdwj8",
                    "relation": "created",
                    "follow_up_due": false,
                    "followed_up_at": null,
                    "follow_up_outcome": null
                }
            ],
            "created_at": "2026-11-14T12:44:09Z",
            "fixed_at": null,
            "released_at": null
        }
    ]
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…

                    

Get an escalation

get /support/escalations/{escalation} support:read

One escalation: how it stands at Monotree, and for each thread it came from whether a follow-up is due.

Parameters

escalation required

string · path

The escalation's ID.
Response · 200 The escalation.

id

string

object

string

category

string

A fault, a wish, or a look into a customer's data.

one of bug, feature_request, investigation

title

string

description

string, nullable

tags

array of strings

Names of the tags it was sent with.

status

string

sent: waiting for Monotree to pick it up. received: Monotree has it. fixed: fixed, not yet shipped. released: it has shipped; follow up on its threads. declined: Monotree will not do it. Every change of status sends support.escalation.updated.

one of sent, received, fixed, released, declined

released_in

string, nullable

The release it shipped in, as Monotree names it.

customer

object, nullable

The customer the person belongs to. Null for a mail from a sender nobody has tied to a customer yet (live only).

id

string

company_name

string

external_ref

string, nullable

Your own reference for the customer.

threads

array of objects

The threads it came from: the one it was made from, and those added to it.

created_at

string, nullable

fixed_at

string, nullable

released_at

string, nullable

Errors

401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no such escalation for your company and mode.
429 rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/support/escalations/esc_01m7d1cbwj6agthjesfk7198t7 \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "id": "esc_01m7d1cbwj6agthjesfk7198t7",
    "object": "support_escalation",
    "category": "bug",
    "title": "Invitation link opens a blank page",
    "description": "On Android 14 the link in the invitation mail opens a blank page.",
    "tags": [
        "Invitations"
    ],
    "status": "sent",
    "released_in": null,
    "customer": {
        "id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
        "company_name": "Boulangerie Martin",
        "external_ref": "org_48213"
    },
    "threads": [
        {
            "id": "sth_01m7d1ajq9w7ak2vnnp8hfdwj8",
            "relation": "created",
            "follow_up_due": false,
            "followed_up_at": null,
            "follow_up_outcome": null
        }
    ],
    "created_at": "2026-11-14T12:44:09Z",
    "fixed_at": null,
    "released_at": null
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…