---
title: "Issue a single-use admin aggregate SSE ticket"
method: POST
path: "/api/v1/admin/events/ticket"
tags: ["Admin", "Events"]
---

# Issue a single-use admin aggregate SSE ticket

`POST /api/v1/admin/events/ticket`

## Request

- Base URL: `https://api.uptimemonitoring.com`
- URL: `https://api.uptimemonitoring.com/api/v1/admin/events/ticket`
- Auth: HTTP bearer

Mints a short-lived ticket scoped to the back-office aggregate
SSE stream at `GET /api/v1/admin/events/stream` (the dot-grid
live feed of every monitor across every account). Requires
Bearer auth AND admin role per `auth.RequireAdmin`. Tickets
minted here are stored in a separate ticket store from the
per-account `/api/v1/events/ticket`; an admin ticket presented
to `/api/v1/events/stream` returns 401 and vice versa.

Ticket TTL is 30 seconds, single-use. Per-admin mint rate is 10
per minute (fixed window) — half the per-account rate, since
admins reconnect rarely. See `docs/SSE_LIVE_UPDATES_SPEC.md` §15.

## Response `200`

Admin ticket issued.

- object
  - `ticket` string, required: Opaque single-use admin token, base64url encoded.
  - `expires_in` integer, required: Seconds until the ticket expires.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: Authenticated but the caller is not permitted on this route. Body is the opaque `{"error":"forbidden"}` envelope used for every admin-gated 403 across the API; the same shape is used whether the caller is missing the admin role or the route otherwise denies them, so clients cannot distinguish the two.
- `429`: Per-admin ticket-mint rate limit exceeded (10 requests/minute, fixed window). The `Retry-After` header gives the integer seconds until the oldest mint slides out of the window.
- `503`: Admin events surface not configured on this dispatcher.

---

[API](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api.md) · [All operations](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api/revisions/ddcb2a8bc70f?raw)
