API reference / Operations
Operations scope: manage
Operational verbs: skip a poison message, fire backing-off retries immediately, deliver a scheduled message now.
POST/v1/subscriptions/{sub}/keys/{key}/skipSkip the message at the head of one lane (poison pill)
Query parameters
| project | Project the name is scoped to. Omitted = "default". Ignored for project API keys — their project is enforced server-side. |
Response · 200
{ "subscription": "payments/billing-worker", "key": "tenant_7",
"skipped": "msg_…" }Errors
| 404 | no subscription named {sub} in project {project} |
| 409 | nothing to skip: the lane has no pending or retrying message (an in-flight message cannot be skipped) |
POST/v1/subscriptions/{sub}/retries/retry-nowFire backing-off retries immediately
Query parameters
| project | Project the name is scoped to. Omitted = "default". Ignored for project API keys — their project is enforced server-side. |
Request body
{ "delivery_ids": ["dlv_…"] }Response · 200
{ "updated": 1 }Errors
| 400 | delivery_ids must be an array |
POST/v1/messages/{id}/deliver-nowFire a scheduled message immediately
Response · 200
{ "id": "msg_…", "status": "available" }Errors
| 409 | only scheduled messages can be delivered now |
| 403 | a project API key naming a resource outside its project |