Skip to main content

Mark a ticket missed

Marks a queued or open ticket as missed. The ticket must currently be in QUEUED or OPEN status — any other status (including already MISSED) returns 422. Requires an admin-tier role on the bot (agent-only API keys are rejected with 401), unlike the other Inbox Ticketing API endpoints.

Path Parameters
id string — REQUIRED

The ticket ID.

Query Parameters
bot string — REQUIRED

The unique ID of the bot.

Responses
200

Ticket marked missed; the updated ticket is returned.

Schema — OPTIONAL
ticket object — OPTIONAL
400

Missing ticket ID or bot.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

401

Missing/invalid API key, or the caller does not hold an admin-tier role on the bot.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

404

Ticket not found.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

422

Ticket is not in QUEUED or OPEN status, so it cannot be marked missed.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

429

Rate limit exceeded.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.

500

Internal server error.

Schema — OPTIONAL
error string — OPTIONAL

Human-readable error message.