Skip to main content
The Superflow REST API lets your own systems automate Superflow, for example creating a project automatically whenever your pipeline deploys a new client site.
If your goal is to let an AI tool work with Superflow, the MCP connector is the better fit: per-user sign-in, no tokens to manage, and a much wider set of capabilities.

​
Authentication

Every request carries two headers:
​
string
required
Your workspace API key.
​
string
required
Your workspace auth token.
Both values are on the Superflow Dashboard under Settings, then Integrations, then REST API. Keep them server-side; anyone holding both can act on your workspace.

​
Conventions

  • Requests are POST with Content-Type: application/json, and the payload wrapped in a data object:
  • Successful responses arrive wrapped in result:
  • Failures arrive wrapped in error, with a message and a status code such as INVALID_ARGUMENT, ALREADY_EXISTS, or RESOURCE_EXHAUSTED:
  • Requests are rate limited per caller and workspace. Space out bursts rather than retrying failures in a tight loop.

​
Endpoints

Create Project

Create a website project, optionally mark it as already installed, and optionally kick off agent checks in the same call.
More endpoints are on the way. If you need one that is not here yet, tell us at hello@usesuperflow.com, or use the MCP connector, which already covers projects, agents, comments, analytics and invitations.