Build with the API

Projects & canvases

Manage projects and create flowcharts, whiteboards, notes, presentations, and templates.

Projects

Everything you create lives as a project. List, fetch, update metadata or content, and delete:

GET/projectsList projects.GET/projects/{id}Get a project.PATCH/projects/{id}Update metadata or content.DELETE/projects/{id}Delete a project.

Creating canvases

Each canvas type has a dedicated creation endpoint accepting the same payloads Theo's in-app tools produce (name plus type-specific content). For generated content, the easiest path is a chat turn: ask Theo and read the created project off the artifacts.

POST/flowchartsCreate a flowchart project.POST/whiteboardsCreate a whiteboard project.POST/notesCreate a notes project.POST/presentationsCreate a presentation project.

Templates

Start from the template gallery instead of a blank canvas:

GET/templatesList templates.POST/templates/{id}/useCreate a project from a template.

Extract a flowchart from a document

Turn a PDF, PPTX, or image into an editable flowchart project in one call (requires the ai scope):

Request body

documentBase64required

string

Base64-encoded document content (no data: prefix). Max 10MB decoded.

mimeTyperequired

application/pdf | pptx | image/png | image/jpeg | image/webp

fileName

string

Original file name (used as a title fallback).

curl

curl https://www.opencharts.com/api/v1/extract-flowchart \
  -H "Authorization: Bearer $OPENCHARTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"documentBase64\": \"$(base64 < process.pdf | tr -d '\n')\",
    \"mimeType\": \"application/pdf\",
    \"fileName\": \"process.pdf\"
  }"