AuroraScope API Reference

Programmatic access to your captures, sessions, and AI script generator. Auth is via your scope token (URL ?token= or header Authorization: Bearer <token>).

Auth

Get your token from the dashboard or after Stripe checkout. Token format: scp_<18-char-base36>.

# URL parameter
curl https://aurorahub.net/scope/sessions?token=scp_xxx

# Header (preferred for ingest)
curl -H "Authorization: Bearer scp_xxx" https://aurorahub.net/scope/sessions

Endpoints

GET /scope/me

Discord login required Returns your tokens (active + expired) with copy-ready loadstrings.

curl -H "Cookie: aurora_session=<jwt>" https://aurorahub.net/scope/me

{
  "discord_username": "you", "discord_id": "...",
  "tokens": [
    { "token": "scp_...", "tier": "scope_pro", "active": true,
      "loadstring": "loadstring(game:HttpGet(\"https://aurorahub.net/scope/agent?t=scp_...\"))()",
      "expires": 1717000000 }
  ]
}

GET /scope/quota?t=<token>

Daily AI generation usage. Pro=5/day, Studio=20/day, Owner=unlimited.

{ "used": 2, "limit": 5, "allowed": true, "tier": "scope_pro" }

GET /scope/agent?t=<token>

Returns your personalized in-game Lua agent (token + tier baked in). Loadstring this in any executor.

POST /scope/ingest

Bearer auth Accepts {type:"hello"|"capture"|"remote-map"}. Used by the agent — you usually don't call this directly.

curl -X POST https://aurorahub.net/scope/ingest \
  -H "Authorization: Bearer scp_xxx" \
  -H "Content-Type: application/json" \
  -d '{"type":"capture","rows":[{"ts":1715000000,"session_id":"...","remote_path":"RS.X","remote_class":"RemoteEvent","method":"FireServer","args_json":"[1,2]"}]}'

GET /scope/sessions?token=<token>&limit=20

Recent sessions for your token, with capture counts.

GET /scope/captures?token=<token>&search=&limit=&since=

Recent captures, filterable by remote_path substring + timestamp.

GET /scope/remotes?token=<token>&limit=50&session_id=

Top unique remotes by hit count, optionally scoped to one session.

GET /scope/export?token=<token>&format=json|csv&session_id=

Download all captures (or one session) as JSON or CSV. Returns Content-Disposition attachment.

DELETE /scope/sessions/<sid>?token=<token>

Removes the session and ALL its captures + remote map. Cannot be undone.

POST /scope/generate?token=<token>

rate-limited Body: {prompt, session_id?, capture_limit?}. Returns AI-generated Lua based on your captures. Pro=5/day, Studio=20/day, Owner=unlimited.

curl -X POST https://aurorahub.net/scope/generate?token=scp_xxx \
  -H "Content-Type: application/json" \
  -d '{"prompt":"auto-farm with rebirth at 1M cash"}'

{
  "ok": true,
  "script": "--!native\n-- Aurora/SAILOR_PIECE v1.0.0\n...",
  "model": "llama-3.3-70b (workers-ai)",
  "captures_used": 150, "remotes_seen": 24,
  "sources": [...],   // populated when AutoRAG is active
  "quota": { "used": 3, "limit": 5, "tier": "scope_pro" }
}

POST /scope/publish

Discord login required rate-limited 3/hr Opt-in publish a script you built to the public Discord channel. Body: {game_id, game_name, loadstring, message?}.

Errors

Code	Meaning
400	Bad input — missing/malformed fields
401	Missing or invalid token / Discord session
403	Token expired — renew at /scope
429	Daily AI quota exhausted — see /scope/quota
503	AI backend unavailable

Workers AI / AutoRAG

Generation is powered by Cloudflare Workers AI running Llama 3.3 70B. When AutoRAG is active, every generation is grounded on AuroraScope's curated knowledge base of Aurora script patterns + per-game intel. The sources array in /scope/generate response shows which docs were retrieved.

Quota tiers

Tier	AI Gens/day	Games tracked	Roblox accounts
Pro ($9/mo)	5	5	1
Studio ($25/mo)	20	25	3
Developer ($50/mo)	100	50	5
Owner	unlimited	unlimited	—

Issues or feature requests? Join the Discord. API stability: this surface is stable for v1; new endpoints may be added but existing ones won't break.