v2 API beta

The v2 API runs Origami’s agent from your code. You send it a brief in plain English, it does the research and builds a table, and you read the result back. The core loop uses three objects:

• Agent — a worker in your org. Create one and reuse it.
• Run — one brief and the work that follows. An agent does one run at a time.
• Table — what the agent builds. Read its rows with GET /api/v2/tables/{tableId}/rows.

The wider API adds workspaces, documents, enrichment runs, campaigns, sequences, scheduled agents, and projects. See objects and relationships for the whole map and how everything connects.

​

How runs work

Every run is asynchronous. POST /api/v2/agents and POST /api/v2/agents/{id}/runs respond 202 Accepted with the run already running — the agent works in the background. You poll GET /api/v2/agents/{id}/runs/{runId} until status is no longer running, honoring the Retry-After header (15 seconds) while it runs. Runs typically take 1–5 minutes. See the run object for the full response shape. Pick a model per run with the model field — origami-lite or origami-max. The default is the highest model your plan unlocks (origami-lite on starter, origami-max on pro and above).

​

Start here

Want the AI to do the work? Use v2. Already have the data and just need to read it back? Use GET /api/v2/tables/{tableId}/rows.