API reference

Fetch this OpenAPI document.

Get the authenticated account (whoami).

Get the plan + AI credit balance.

List personas.

Create a persona.

Get a persona.

Path params: {id}

Update a persona.

Path params: {id}

Delete a persona.

Path params: {id}

Publish a persona.

Path params: {id}

List a persona's deployments.

Path params: {id}

Create a persona deployment.

Path params: {id}

Start a persona conversation.

Path params: {id}

End a persona conversation.

Path params: {id}, {cid}

List conversation events.

Path params: {id}, {cid}

List available persona faces.

List projects.

Get a project.

Path params: {id}

Update a project's metadata or content.

Path params: {id}

Delete a project.

Path params: {id}

Create a flowchart project.

Create a whiteboard project.

Create a notes project.

Create a presentation project.

List templates.

Create a project from a template.

Path params: {id}

List sheets.

Create a sheet.

Read a sheet's rows.

Path params: {id}

Read a sheet range.

Path params: {id}

Apply or propose structured sheet ops.

Path params: {id}

Edit a sheet with a natural-language instruction.

Path params: {id}

List a sheet's commits.

Path params: {id}

Get a commit diff.

Path params: {id}, {commitId}

Merge or reject a proposed commit.

Path params: {id}, {commitId}

Roll a sheet back to a commit.

Path params: {id}

List boards.

Create a board.

Get a board.

Path params: {id}

Update a board.

Path params: {id}

Delete a board.

Path params: {id}

Duplicate a board.

Path params: {id}

List a board's cards.

Path params: {id}

Create a card.

Path params: {id}

Update a card.

Path params: {id}, {cardId}

Delete a card.

Path params: {id}, {cardId}

Run a Theo chat turn (UI-message SSE stream by default; `stream: false` for the assembled message + artifacts).

List conversations.

Create a conversation.

Get a conversation.

Path params: {id}

Update a conversation's title or mode.

Path params: {id}

Delete a conversation and its messages.

Path params: {id}

List a conversation's messages (oldest first).

Path params: {id}

Extract a flowchart project from a document (PDF, PPTX, or image).

Generate an image synchronously.

Start a video generation job (pick a tier: Fast, Max, Cinema, or Cinema Ultra).

Start a song generation job.

Start a Code Canvas build job.

Poll any async job by its type-prefixed id.

Path params: {id}

OpenAI-compatible chat completion over a Theo Agent (`model: "agent:<agentId>"`; the agent runs inline and replies, as JSON or as a single-chunk SSE stream when `stream: true`).

Dispatch a Theo Agent.

Path params: {id}

Send a message to a goal-driven agent on a conversation thread (returns the run id to poll for the reply).

Path params: {id}

List an agent's runs.

Path params: {id}

Get an agent run's status.

Path params: {id}, {runId}

Get an agent run's result: the reply, artifacts, pending approval, credits.

Path params: {id}, {runId}

Approve or reject the action a paused agent run is waiting on (owner only).

Path params: {id}, {runId}

Get an agent's run + credit usage over a window (`?days=7`, 1 to 90).

Path params: {id}

Start a deep-research job (returns a res_-prefixed job id; poll it at GET /jobs/{id}).

Poll a deep-research job (legacy alias of GET /jobs/{id}; accepts raw or res_-prefixed ids).

Path params: {jobId}

List webhooks.

Register a webhook (secret returned once).

Get a webhook.

Path params: {id}

Update a webhook.

Path params: {id}

Delete a webhook.

Path params: {id}

List a webhook's recent deliveries.

Path params: {id}