Machina API
The Machina API is a REST API that runs on your project's own pod — there's no package to install; you call it directly over HTTP.
Every request is authenticated the same way as MCP and the CLI: an X-Api-Token header, scoped to your project.
Quickstart Guides
API schemas
Check API interaction schemas for headers, requests and responses.
Create API key
Access Machina Studio and generate a new API key for your integration.
Endpoints
Discover how our API can elevate your experience with features designed to enhance user engagement and data insights. Start by obtaining an API key and authenticating your requests to interact with our endpoints.
Agent
Create, search, execute, and manage agents that run your workflows on a schedule.
Document
Store and retrieve the JSON records, uploads, and generated files your agents read and write.
Workflow
Execute and schedule the pipelines that orchestrate connectors, mappings, and AI agents.
Skill
Create, search, execute, and manage the packaged capabilities your agents invoke.
Beyond these four
Agent, Document, Workflow, and Skill are the resources with a published API reference today. Other parts of the platform — like Connectors, Mappings, and Prompts — are reachable through the CLI and Studio, but don't have a published HTTP API reference yet.
Related
- Quickstart — choose between MCP, CLI, API, and Studio.
- MCP and Machina CLI — the other two ways to talk to the same underlying API, authenticated the same way.

