Schedule Details

Get the full configuration for a schedule plus its 10 most recent execution records.

GET /api/v1/schedules/{id}

Path Parameters

Request Example

curl -X GET "https://agent.rolli.ai/api/v1/schedules/660e8400-e29b-41d4-a716-446655440111" \
  -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/schedules/660e8400-e29b-41d4-a716-446655440111", {
  method: "GET",
  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/schedules/660e8400-e29b-41d4-a716-446655440111")
req = Net::HTTP::Get.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/schedules/660e8400-e29b-41d4-a716-446655440111"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}response = requests.get(url, headers=headers)

print(response.json())
    

Response Example

{
  "id": "660e8400-e29b-41d4-a716-446655440111",
  "name": "Daily Crypto Trends",
  "question": "What is trending in crypto?",
  "mode": "trend_briefing",
  "time_window": "7d",
  "platforms": ["twitter", "reddit"],
  "recurrence_type": "daily",
  "recurrence_time": "09:00",
  "recurrence_timezone": "America/New_York",
  "starts_at": "2026-05-20T09:00:00Z",
  "next_run_at": "2026-05-20T13:00:00Z",
  "enabled": true,
  "paused": false,
  "notify_email": "[email protected]",
  "notify_slack_webhook": "[configured]",
  "consecutive_failures": 0,
  "run_count": 12,
  "last_run_status": "completed",
  "last_run_at": "2026-05-19T13:00:00Z",
  "recent_runs": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440222",
      "status": "completed",
      "scheduled_for": "2026-05-19T13:00:00Z",
      "started_at": "2026-05-19T13:00:15Z",
      "ended_at": "2026-05-19T13:04:30Z",
      "agent_run_id": "550e8400-e29b-41d4-a716-446655440000",
      "error": null,
      "notified_at": "2026-05-19T13:04:31Z",
      "created_at": "2026-05-19T13:00:00Z"
    }
  ]
}

For the full execution history, use GET /api/v1/schedules/{id}/runs.