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
projectProject 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
404no subscription named {sub} in project {project}
409nothing 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
projectProject 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
400delivery_ids must be an array
POST/v1/messages/{id}/deliver-nowFire a scheduled message immediately
Response · 200
{ "id": "msg_…", "status": "available" }
Errors
409only scheduled messages can be delivered now
403a project API key naming a resource outside its project
← IntrospectionAll topicsProjects & API keys →