Initializing Operalta...

Operalta

REST API: Automation & Agents

Sync, OAuth, GitHub-linked workflows, and agent invoke or poll endpoints

Agent invoke/poll, orchestration, sync, OAuth, and GitHub.

01

Council / Panel / Research / Deep Research (invoke & poll)

  • -POST /api/{council|panel|research-panel|deep-research}/invoke — start a run.
  • -GET /api/{council|panel|research-panel|deep-research}/result?runId=... — poll status and final output.
  • -Use agents.runs:read and agents.runs:write scopes for new integrations.
02

Agent orchestration

  • -POST /api/orchestrate/route — pick a rail for a question and run it.
  • -POST /api/agent/run — start a generic canonical run.
  • -GET /api/agent/runs?status=running&limit=20 — list runs.
  • -GET /api/agent/run/:runId — read a run.
  • -GET /api/agent/run/:runId/progress — SSE progress stream.
  • -POST /api/agent/run/:runId/save — persist the final output as an artifact.
03

Sync & GitHub

  • -POST /api/sync/connect — start the GitHub OAuth flow; returns an authorize URL. GET returns the connect-status payload only.
  • -GET|DELETE /api/sync/connections — list or remove provider connections.
  • -GET|POST /api/sync/targets — list or create sync targets (repos, drives, sheets).
  • -POST /api/sync/targets/:targetId/sync — run a sync for one target.
  • -POST /api/sync/execute — execute a sync directly without a stored target.
  • -GET /api/sync/operations — list recent sync operations.
  • -GET /api/sync/repos — list connected GitHub repos.
04

OAuth, GitHub, CLI sync & metric sharing

  • -GET|POST /api/oauth/clients — manage OAuth apps (admin).
  • -POST /api/oauth/clients/:id/rotate-secret — rotate the client secret.
  • -POST /api/cli/authorize — browser-session start of CLI login. GET|DELETE validates or revokes the issued bearer.
  • -POST /api/integrations/:provider/connect — start the provider OAuth flow; returns the connection URL. GET returns provider config status only. GET /api/integrations/:provider/callback completes the flow.
  • -GET|POST /api/metrics/grants — list or create metrics-sharing grants. PATCH /api/metrics/grants/:id/revoke to revoke.