Skip to content
Scope

Retry a request (start a new attempt)

POST
/api/v1/requests/{id}/retry
 
curl --request POST \
  --url https://example.com/api/v1/requests/example/retry \
  --header 'Content-Type: application/json' \
  --data '{ "force": true }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Request Body

Section titled “Request Body ”
Media type application/json
object
force
boolean
Example generated
{
  "force": true
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Success

Media type application/json
object
requestId
required
string
runId
required
string
attemptNumber
required
integer
Example generated
{
  "requestId": "example",
  "runId": "example",
  "attemptNumber": 1
}

404

Section titled “404 ”

Request not found

409

Section titled “409 ”

Conflict — request is not in a retryable state, or a concurrent retry won the race

422

Section titled “422 ”

Cannot retry — current run not yet terminal