Platform reference

meta

• GET /api/v1/health — Unauthenticated health probe
• GET /api/v1/prices — The machine-readable price list: plans, what a credit is worth, the rate, the about-number per kind of work (unauthenticated)

agent

• POST /api/v1/ask — Ask their Chief of Staff (Idempotency-Key: one turn, one charge; about 25 s, then working + turn_id)
• GET /api/v1/turns/{id} — A turn's answer (long poll with ?wait_seconds=)
• GET /api/v1/events — What happened on their matters since a cursor
• GET /api/v1/record — Their record with each expert: resolved calls per expert and domain
• GET /api/v1/contexts/{id} — One context the key's grant opens: what it is for, its own shape (`schema`: record types and their fields), members, files, kept records (each with its `type`, its `fields` by the schema's keys and the page each came from), decisions; ?query= adds the matching pages
• POST /api/v1/contexts/{id}/proposals — Propose records into a granted context in its own shape (`type`, `fields` by the schema's keys, sub-rows' `cells`); kept only when the person keeps them

matters

• GET /api/v1/matters — Their matters (rooms, one-offs or closed), paged
• GET /api/v1/matters/{id} — One matter: its record, its files, whether it is followed
• POST /api/v1/matters/{id}/follow — Stop following (on: false); Keep following stays the person's own yes (409 with the quote)
• POST /api/v1/matters/{id}/watch — Stop watching for a reply (on: false); starting a watch stays the person's own yes (409 with the price and the link)

sessions

• POST /api/v1/sessions — Start a session (plan_id or explicit setup; session_type boardroom | consult)
• GET /api/v1/sessions — List sessions with filter/sort/cursor
• POST /api/v1/sessions/plan — Propose a session setup + credit estimate without starting
• GET /api/v1/sessions/{id} — Get session state + latest task (v4_phase, decision_brief, memo, board_artifact)
• PATCH /api/v1/sessions/{id} — Rename / retag a session
• DELETE /api/v1/sessions/{id} — Hard-delete a draft session
• POST /api/v1/sessions/{id}/continue — Follow-up round (legacy-engine sessions)
• POST /api/v1/sessions/{id}/reconvene — Chain a new board round on a completed V4 board (returns new_session_id)
• POST /api/v1/sessions/{id}/messages — Send one Consult turn (expert reply + composed document)
• POST /api/v1/sessions/{id}/cancel — Cancel the in-flight task
• POST /api/v1/sessions/{id}/outcomes — Generate a deliverable (action plan / report / memo / bullets)
• POST /api/v1/sessions/{id}/export — Export as markdown / JSON / text
• POST /api/v1/sessions/{id}/archive — Archive or unarchive
• POST /api/v1/sessions/{id}/fork — Duplicate with altered context (rerun optional)
• POST /api/v1/sessions/{id}/update — Mid-session mutations (synths, mode, DNA tuning)
• GET /api/v1/sessions/{id}/live-summary — Live consensus snapshot
• GET /api/v1/sessions/{id}/cross-round — Cross-round position trends
• POST /api/v1/sessions/{id}/assistant — Ask the Session Assistant
• POST /api/v1/sessions/{id}/bookmarks — Bookmark a moment or pin a thread
• POST /api/v1/sessions/{id}/decisions — Capture a formal decision record
• POST /api/v1/sessions/{id}/promote-to-synth — Promote session documents into synth knowledge

calls

• POST /api/v1/calls — Put a call on the record from her card (the person's yes; one start per card)
• GET /api/v1/calls — List the person's calls on the record (status, paged)
• GET /api/v1/calls/{id} — A call: each expert's take, the chair, the dates, the decision and the outcome
• POST /api/v1/calls/{id} — Report a decision or an outcome (pending until the person confirms)

synths

• POST /api/v1/synths/chat — 1-on-1 chat with a synth in a session
• GET /api/v1/synths — List synths (core + public + your own)
• POST /api/v1/synths — Create a custom synth
• GET /api/v1/synths/{id} — Get a synth
• PATCH /api/v1/synths/{id} — Update a custom synth
• DELETE /api/v1/synths/{id} — Delete a custom synth
• PATCH /api/v1/synths/{id}/preferences — Set per-user core-synth preferences
• DELETE /api/v1/synths/{id}/preferences — Reset core-synth preferences
• GET /api/v1/synths/{id}/knowledge — List a synth's knowledge files
• POST /api/v1/synths/{id}/knowledge — Add knowledge (URL or text)
• DELETE /api/v1/synths/{id}/knowledge/{fileId} — Remove a knowledge file

catalog

• GET /api/v1/catalog/search — Search synths / modes / templates / strategies / models

shares

• GET /api/v1/shares — List shares for a session
• POST /api/v1/shares — Create a share link
• DELETE /api/v1/shares/{id} — Revoke a share by share code
• POST /api/v1/shares/verify-password — Verify a password-protected share

actions

• POST /api/v1/actions/execute — Execute a Recommended Action via a connected tool
• POST /api/v1/actions/undo — Undo an executed action (30 s window)
• GET /api/v1/integrations — List connected integration providers

webhooks

• GET /api/v1/webhooks — List webhook subscriptions
• POST /api/v1/webhooks — Create a subscription (signing secret returned once)
• PATCH /api/v1/webhooks/{id} — Update / enable / disable a subscription
• DELETE /api/v1/webhooks/{id} — Delete a subscription
• GET /api/v1/webhooks/{id}/deliveries — Recent delivery attempts for a subscription

files

• GET /api/v1/files/{id} — A file made for the person (Word, Excel, PDF, calendar, PNG) as a signed short-lived link