Retry stopped deliveries
POST/app_installs/:id/retry_deliveries
After ten dead letters in a row (or a 410) the install's webhook subscription stops and the
install reads "Failing". This turns it back on and resends its dead letters oldest
first — only those the app's current grant still covers — 100 in this request, the rest paced
in the background. integrations.manage; 422 not_installed / install_paused /
app_suspended / no_subscription. Throttles: app_installs/retry_deliveries/minute (5 a minute)
on top of the write bucket, app_installs/write/minute (30 a minute).
A signed-in session or the person's own personal access token; an app's OAuth token is refused
(403 resource_not_grantable).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
The install.
No session or token, or one that is no longer valid. A request that presented a token gets
WWW-Authenticate: Bearer realm="KudosCRM", error="invalid_token" (refresh it); one with no
credentials and no session cookie gets the bare challenge.
Response Headers
Bearer realm="KudosCRM", error="invalid_token"Not allowed: the permission this route needs is missing, the Integrations module is off
(code: module_disabled, meta.module_key, meta.blocked_at_layer), or the caller is an app's
own OAuth token (code: resource_not_grantable).
Not found in this workspace — or not something the caller may know exists.
The install's lifecycle refused the change: not_installed / already_uninstalled (an uninstalled
install), already_paused / not_paused, invalid_decision / nothing_pending (re-consent),
install_paused / app_suspended / no_subscription (retries), not_replayable /
payload_gone / subscription_inactive / not_granted / not_subscribed (replays), test_unavailable.
A throttle refused the request. Wait Retry-After seconds — the time left in the refusing window
plus 0–3 s of jitter. The X-RateLimit-* headers describe the bucket that refused it.
Response Headers
Seconds until the window rolls.