Scrolls

A scroll is one bounded research run. ViralQuery starts a fresh EVE session, appends the exact workspace rules and optional prompt, and lets the agent choose documented Scrape Creators searches inside a tenant-isolated smart-code workstation. The provider request, runtime, archive, and hook budgets are enforced outside the model.

Start a scroll

curl -X POST https://api.viralquery.com/v1/scrolls \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "weekly-2026-07-10",
    "prompt": "Look for strong organic demos and visual hooks from the last month."
  }'

The response is 202 Accepted with a scroll ID. Reusing the same idempotency key returns the same scroll without consuming another included run.

Only one scroll can be queued or running for a workspace by default. Included scrolls are reserved when queued and become completed usage only after the personalized library is updated. A dispatch or worker failure releases the reservation.

Check status

curl "https://api.viralquery.com/v1/scrolls?id=$SCROLL_ID" \
  -H "Authorization: Bearer $KEY"

Statuses are queued, running, completed, failed, or cancelled. The response also includes the current stage, bounded progress, result counts, and a stable failure code when applicable.

The bearer key always determines the workspace. A scroll ID owned by another account is returned as not found, and neither the API nor the agent SDK accepts an account or workspace selector.