Machina SDK Overview

The Machina SDK 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.

What's documented so far

Agent

Create, search, execute, and manage agents.

Workflow

Execute and schedule pipelines.

Document

Store and retrieve records, uploads, and generated files.

Skill

Create, search, execute, and manage packaged capabilities.

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

• API Reference — the full endpoint list documented so far.
• MCP and Machina CLI — the other two ways to talk to the same underlying API, authenticated the same way.