Rolli
Rolli API Documentation

Update a Run

Rename or pin a run. Useful for organizing reports for later reference.

PATCH /api/v1/runs/{id}

Path Parameters

idRequired — the run UUID.

Body Parameters

pinnedOptional — boolean. Pin or unpin the run.
labelOptional — custom label (e.g., "Weekly trend report", "Client research").

At least one of pinned or label is required.

Request Example

curl -X PATCH "https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-ROLLI-TOKEN: your_token" \
  -H "X-ROLLI-USER-ID: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
  "pinned": true,
  "label": "Weekly trend report"
}'
    
fetch("https://agent.rolli.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000", {
  method: "PATCH",
  headers: {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"pinned":true,"label":"Weekly trend report"})
})
  .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")
req = Net::HTTP::Patch.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"
req.body = {"pinned":true,"label":"Weekly trend report"}.to_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"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}

payload = {
  "pinned": true,
  "label": "Weekly trend report"
}
response = requests.patch(url, json=payload, headers=headers)

print(response.json())

Response Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "pinned": true,
  "label": "Weekly trend report"
}

Returns 422 Unprocessable Entity if no fields are supplied.