Operator bulk retry for failed deposits matching a filter

Operator-only endpoint. Retry every failed deposit for the target project that matches the supplied filter. Requires the deposit_retry API-key scope, a projectId, and at least one narrowing filter (chain, errorCode, failedAfter, failedBefore).

POST /admin/deposits/retry/bulk

Operator bulk retry for failed deposits matching a filter

cURL

curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/deposit-processor/admin/deposits/retry/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "projectId": "proj_abc123",
  "chain": "eip155:8453",
  "errorCode": "BRIDGE_TIMEOUT",
  "failedAfter": "2023-11-07T05:31:56Z",
  "failedBefore": "2023-11-07T05:31:56Z"
}
'

200

{
  "message": "<string>",
  "count": 123,
  "deposits": [
    {
      "id": "<string>",
      "txHash": "<string>",
      "chain": "<string>"
    }
  ]
}

Headers

x-api-key · string · required

API key for authentication

Example:

"your-api-key"

x-api-version · string

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Pattern: ^\d{4}-\d{2}\.[a-z0-9]+$

Example:

"2026-04.amazon"

Body

application/json

projectId · string · required

Target user-service project id whose failed deposits should be retried.

Minimum string length: 1

Example:

"proj_abc123"

chain · string

Limit to a single CAIP-2 chain

Pattern: ^[a-z0-9]+:[a-zA-Z0-9]+$

Example:

"eip155:8453"

errorCode · string

Limit to deposits that failed with this error code

Minimum string length: 1

Example:

"BRIDGE_TIMEOUT"

failedAfter · string<date-time>

ISO timestamp; include only deposits updated at/after this

failedBefore · string<date-time>

ISO timestamp; include only deposits updated at/before this

Response

200

application/json

Bulk retry initiated

message · string · required

count · number · required

deposits · object[] · required

Show child attributes