Rolli
Rolli API Documentation

Rolli Agent

AI-driven social intelligence runs and scheduled reports. Submit a plain-English question and receive a structured markdown report with signals, evidence links, and a confidence rating.

The Agent autonomously plans a search strategy, queries Rolli IQ across platforms, analyzes posts, and produces a markdown report. Runs execute asynchronously: POST returns a run ID immediately and you poll GET /api/v1/runs/{id} until status reaches completed or failed.

Base URL
https://agent.rolli.ai

Runs Endpoints

  • POST /api/v1/runs — start a new investigation
  • GET /api/v1/runs — list your runs
  • GET /api/v1/runs/{id} — fetch a run's progress or result
  • POST /api/v1/runs/{id}/cancel — cancel a pending or running run
  • POST /api/v1/runs/{id}/rerun — retry a failed run
  • PATCH /api/v1/runs/{id} — rename or pin a run
  • DELETE /api/v1/runs/{id} — soft-delete a run

Schedules Endpoints

  • GET /api/v1/schedules — list scheduled reports
  • POST /api/v1/schedules — create a scheduled report
  • GET /api/v1/schedules/{id} — get schedule details
  • PATCH /api/v1/schedules/{id} — update a schedule
  • DELETE /api/v1/schedules/{id} — delete a schedule
  • POST /api/v1/schedules/{id}/pause — pause a schedule
  • POST /api/v1/schedules/{id}/resume — resume a paused schedule
  • GET /api/v1/schedules/{id}/runs — list a schedule's execution history

All requests use the same X-ROLLI-TOKEN and X-ROLLI-USER-ID headers as the rest of the Rolli API. Credits are debited against the credential owner's IQ balance when a run completes.