Developers

Nodaro is built REST-first: the Nodaro editor, the TypeScript SDK and the CLI all talk to the same HTTP API, so anything you do in Nodaro can be automated with a bearer token and a JSON request. This section documents that API, its clients, the ways to authenticate, and the ways to put Nodaro inside your own product. AI assistants reach the same workflows and models through the MCP server.

Three ways in

The SDK has no dependencies: it uses only fetch and URL, so it runs in Node 18 or newer, in browsers, in React Native, and on Cloudflare Workers, Deno and Bun. The CLI is a thin wrapper around the SDK: anything the CLI does, the SDK does too.

The same call in each of them, running a saved workflow:

curl -s -X POST https://app.nodaro.ai/v1/workflows/8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f/run \
  -H "Authorization: Bearer $NODARO_API_KEY"
# {"executionId":"3f9e2b1a-…","status":"pending"}

import { createClient, StaticTokenAuth } from '@nodaro/sdk'

const client = createClient({
  baseUrl: 'https://app.nodaro.ai',
  auth: new StaticTokenAuth(process.env.NODARO_API_KEY!),
})

const { executionId } = await client.workflows.run('8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f')

nodaro auth login --token "$NODARO_API_KEY"
nodaro workflows run 8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f --watch

Three things work the same way everywhere:

• Run anything. Run a saved workflow, a published app, or a single node with POST /v1/<node-type>, without building a workflow.
• Poll for results. Generations take seconds to minutes, so a run returns an id at once and you poll its job or execution. The SDK and the CLI can wait for you.
• Discover without a token. GET /v1/nodes and GET /v1/models list every node and model, with their settings and credit prices.

Authenticate

API tokens are available on Nodaro Cloud and the Business edition. A self-hosted install can also run its generations on Nodaro Cloud with a personal API token, without OAuth. Read Authentication and OAuth apps.

OpenAPI spec

The server publishes an OpenAPI 3.1 spec of the API's core at https://app.nodaro.ai/v1/openapi.json. Generate a typed client for Go, Rust, Python or any other language from it. See OpenAPI spec.

For AI agents

• MCP. Add https://mcp.nodaro.ai/mcp as a custom connector in Claude, ChatGPT, Cursor and other MCP clients. The assistant signs in with your Nodaro account and gets tools to generate media, build and run workflows, and manage characters and other assets. See MCP.
• Agent skills. Skill files teach coding assistants such as Claude Code and Cursor how to use the SDK and how to build an OAuth app. See Agent skills.

Put Nodaro in your product

• Embed an app. Run a published Nodaro app from your own web or mobile interface. See Embeds.
• Build the pickers yourself. The Creative Controls catalogs ship as data in @nodaro/shared, so your app can offer the same choices and write the same prompts. See Picker catalogs.
• Sign users in with your identity provider. See SSO.
• Charge through your own wallet. A deployment can authorize each customer's spending through its own wallet. See External wallet.

Explore the developer docs