Rerun a Failed Run

Name: Rolli app
Address: 1212 5th Street, Suite 1-400,, Santa Monica, CA, 90401, US

Retry a failed (or stuck) run. Resets the run to pending and re-enqueues it.

POST /api/v1/runs/{id}/rerun

Path Parameters

id	Required — the run UUID.

Request Example

curl -X POST "https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/rerun" \
  -H "X-ROLLI-TOKEN: your_token" \
  -H "X-ROLLI-USER-ID: your_user_id" \
  -H "Content-Type: application/json"

fetch("https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/rerun", {
  method: "POST",
  headers: {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
  },
})
  .then(res => res.json())
  .then(console.log);

require "net/http"
require "uri"
require "json"

uri = URI("https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/rerun")
req = Net::HTTP::Post.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

puts res.body

import requests
import json

url = "https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/rerun"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}response = requests.post(url, headers=headers)

print(response.json())

Response Example

HTTP 202 Accepted. The run is re-queued — poll GET /api/v1/runs/{id} for results.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending"
}

Works on failed, waiting, or running runs (running runs are force-cancelled first). Returns 422 if the run is already completed.