# SayDiagram

> Describe or photograph a diagram → arrange on a visual canvas → paste into Figma and other design tools. Editable Mermaid underneath.

## Public API (Pro / Team)

- Base URL: https://saydiagram.com/api/v1
- Auth: Authorization: Bearer sd_live_…  OR  X-Api-Key: sd_live_…
- Create keys: https://saydiagram.com/profile (API keys section)
- OpenAPI: https://saydiagram.com/openapi.json
- Full agent guide: https://saydiagram.com/llms-full.txt
- Human docs: https://saydiagram.com/doc/public-api
- Agent docs: https://saydiagram.com/doc/agents

## Endpoints

- GET https://saydiagram.com/api/v1/me — plan + daily idea/scan quotas
- POST https://saydiagram.com/api/v1/diagrams/from-idea — JSON { idea, diagramType?, folderId? }
- POST https://saydiagram.com/api/v1/diagrams/from-image — multipart file=… or JSON { imageBase64, mimeType?, filename?, folderId? }

## Rules for agents

- Never put API keys in browser / client-side code or commit them to git.
- Call the API from a server or trusted automation environment.
- Respect daily quotas and 429 AI_RATE_LIMIT; Free plans cannot use keys.
- Successful creates return a Diagram DTO including editorUrl.