API ReferenceRetries and Dead Letters
Update a retry policy
PATCH /retries/policies/{id}
Update a retry policy
Update a retry policy.
https://api.edgecron.com/v1/retries/policies/{id}
Authentication required
Send `X-Key-ID`, `X-Timestamp`, and `X-Signature` with every request. The signature is lowercase hex HMAC-SHA256 over `timestamp + "\n" + payload`.
Parameters
| Parameters | In | Type | Required | Description |
|---|---|---|---|---|
id | path | integer | Yes | Resource identifier. |
Request body
| Parameters | Type | Required | Description |
|---|---|---|---|
name | string | No | - |
max_attempts | integer (int32) | No | - |
backoff_type | fixed / exponential | No | Allowed: fixed, exponential. |
initial_delay_sec | integer (int32) | No | - |
max_delay_sec | integer (int32) | No | - |
status | active / paused | No | Allowed: active, paused. |
{
"name": "billing-webhook",
"max_attempts": 1,
"backoff_type": "fixed",
"initial_delay_sec": 1,
"max_delay_sec": 1,
"status": "active"
}Response
All successful responses use the EdgeCron API envelope.
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"id": 101,
"app_id": "app_123",
"name": "billing-webhook",
"max_attempts": 1,
"backoff_type": "fixed",
"initial_delay_sec": 1,
"max_delay_sec": 1,
"status": "string",
"created_at": "2026-07-01T12:00:00Z"
}
}Schema
| Parameters | Type | Required | Description |
|---|---|---|---|
id | integer | No | Resource identifier. |
app_id | string | No | Application identifier. |
name | string | No | - |
max_attempts | integer | No | - |
backoff_type | fixed / exponential / linear | No | Allowed: fixed, exponential, linear. |
initial_delay_sec | integer | No | - |
max_delay_sec | integer | No | - |
status | string | No | Current lifecycle state. |
created_at | string (date-time) | No | Creation timestamp. |