# FLORA API

> Developer documentation for the FLORA public API and FLORA MCP.

## Docs

- [Getting Started](/api/): Start using the FLORA API to run techniques programmatically.
- [Assets](/guides/assets/): Upload, retrieve, retry, and attach media assets.
- [Feedback](/guides/feedback/): Report public API bugs, feature requests, and missing capabilities.
- [Generations](/guides/generations/): Start a one-off model generation without a saved technique.
- [Models](/guides/models/): List available FLORA models.
- [Projects](/guides/projects/): Create, list, retrieve, and attach assets to FLORA projects.
- [Techniques](/guides/techniques/): Discover technique schemas and start technique runs.
- [Workspaces](/guides/workspaces/): List the FLORA workspaces available to your API key.
- [FLORA MCP](/mcp/): Run FLORA Techniques from any MCP-compatible agent — Claude, Cursor, VS Code, Codex, and more.
- [Authentication](/mcp/authentication/): How FLORA MCP authenticates with your FLORA account over OAuth.
- [Claude (web & Desktop)](/mcp/install/claude/): Install FLORA MCP as a custom connector in Claude.ai and Claude Desktop.
- [Claude Code](/mcp/install/claude-code/): Install FLORA MCP in Claude Code with one command.
- [OpenAI Codex](/mcp/install/codex/): Add FLORA MCP to OpenAI Codex via the CLI or config.toml.
- [Cursor](/mcp/install/cursor/): Add FLORA MCP to Cursor via config file or one-click install.
- [Hermes Agent](/mcp/install/hermes/): Add FLORA MCP to Nous Research's Hermes Agent via config.yaml.
- [OpenClaw](/mcp/install/openclaw/): Add FLORA MCP to OpenClaw with the openclaw mcp CLI.
- [Other clients](/mcp/install/other-clients/): Connect FLORA MCP from any client that supports remote HTTP MCP servers.
- [VS Code](/mcp/install/vscode/): Add FLORA MCP to VS Code with one CLI command or by editing mcp.json.
- [Batch with a coding agent](/mcp/recipes/batch-with-coding-agent/): Combine FLORA MCP with any coding agent and external data sources to batch-run Techniques.
- [Discover and run](/mcp/recipes/discover-and-run/): Paste a brief, find the right Technique, generate a grid of options.
- [Generate without a Technique](/mcp/recipes/generate-without-a-technique/): Run a model straight from a prompt — no saved Technique required.
- [Iterate on favorites](/mcp/recipes/iterate-on-favorites/): Use prior outputs as inputs to explore variations of the ones you like.
- [Prompting tips](/mcp/recipes/prompting-tips/): How to ask any MCP-compatible agent to use FLORA effectively.
- [Stills to motion](/mcp/recipes/stills-to-motion/): Branch from one Technique into another, carrying selected outputs as inputs.
- [Tools reference](/mcp/tools/): The two MCP tools the FLORA server exposes, plus the full SDK method surface available inside execute.
- [Troubleshooting](/mcp/troubleshooting/): Common FLORA MCP problems and how to resolve them.
- [Authentication](/platform/authentication/): Create and manage API keys for the FLORA REST API.
- [Errors](/platform/errors/): Every FLORA API error code, what it means, and how to recover.
- [Idempotency](/platform/idempotency/): Safely retry FLORA mutations without duplicating runs or assets.
- [Webhooks](/platform/webhooks/): Receive a signed callback when a FLORA run finishes, and verify it before you trust it.
- [CLI](/quickstarts/cli/): Install the FLORA CLI and run your first Technique from the terminal.
- [TypeScript](/quickstarts/typescript/): Install the FLORA TypeScript SDK and run your first Technique.
- [Batch from a CSV](/recipes/batch-from-csv/): Process a spreadsheet of inputs with idempotency, parallelism, and backoff.
- [Generate a grid](/recipes/generate-a-grid/): Run a Technique with N outputs and render them as a grid.
- [Iterate on outputs](/recipes/iterate-on-outputs/): Re-run a Technique using previous outputs as image references.
- [Upload an asset](/recipes/upload-an-asset/): Upload a local image for a Technique input with FLORA MCP, a signed upload reservation, local shell curl, and asset completion.

## API reference

- [API Reference](/reference/): endpoint-by-endpoint reference generated from the OpenAPI spec.