Retry blocked workflow runs

POST

/v1/forms/{form}/workflow-runs/retry-batch

curl --request POST \
  --url https://api.submeto.com/v1/forms/example/workflow-runs/retry-batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "limit": 1 }'

Retries the oldest CP-blocked runs for one Form, bounded to 100. Requires workflows:write, an idempotency key, and explicit user confirmation.

Authorizations

• default

Parameters

Path Parameters

form

required

string

The form ID.

Header Parameters

Idempotency-Key

string

Request Body

Media typeapplication/json

object

limit

Maximum runs to retry (1-100, default 100).

integer

Example^generated

{
  "limit": 1
}

Responses

202

Batch retry accepted

Media typeapplication/json

object

data

object

selected

integer

restarted

integer

still_blocked

integer

request_id

string

Example

{
  "data": {
    "selected": 3,
    "restarted": 3,
    "still_blocked": 0
  },
  "request_id": "REQUEST_ID"
}