Skip to main content
Every workflow you save on Knouds is automatically available as a REST endpoint — no deployment step required. The workflow’s Request Input fields define the JSON body the caller must provide, and the Response Output node determines what comes back. This guide walks you through calling a saved workflow from any HTTP client.

​
How it works

When you save a workflow, Knouds assigns it a permanent slug derived from its name (for example, product-image-generator). You call the workflow by posting to: 
POST https://knouds.ai/api/workflows/{slug}/run
The workflow executes server-side — all model credentials stay on Knouds servers and are never exposed to the caller.
1

Ensure your workflow has a Request Input node

The JSON body you send to the API maps directly to the fields you define on a Request Input node. If your workflow does not have one, add it from the Inputs category in the sidebar and define each field your callers should provide.For example, a field named prompt of type Text means callers must send {"inputs": {"prompt": "..."}} in the request body.
2

Find the workflow slug

The slug appears in the URL when you are editing the workflow:
https://knouds.ai/app/editor/your-workflow-slug
The part after /editor/ is your slug. You can also find it on the Knouds home page by hovering over a workflow card — the URL shown is your slug.The slug is set at creation time from the workflow name and cannot be changed. If your slug is not descriptive, you will need to create a new workflow with a better name.
3

Generate an API key

Open the Developer Dashboard (or Settings → API Keys, which redirects). Click Create Key and pick a preset:
  • Workflow Deploy — workflow:run + workflow:read. The right preset for most production integrations.
  • Read-only — workflow:read only. Useful for audit/monitoring keys.
  • Webhook receiver — webhook:receive. Use when configuring outbound webhook delivery for ?async=true runs.
  • Full deploy — workflow:run + workflow:read + workflow:write. Adds the ability to create/update/delete workflows via API.
  • Custom — pick exact capabilities (per-flow allowlist via workflow:<slug>:run, per-model allowlist via model:<id>:run, etc.).
Free tier cannot create usable API keys — the Free API key ceiling is empty by product design. Upgrade to Pro to unlock key creation. Creator tier is canvas only and also cannot create API keys.
Copy the key immediately — it is shown only once. Store it securely (see Create and manage API keys).
4

Call the workflow

Send a POST request with your API key in the x-api-key header and the input values in the inputs object:
curl -X POST https://knouds.ai/api/workflows/your-workflow-slug/run \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"prompt": "a golden retriever at sunset"}}'
A successful response looks like:
{
  "success": true,
  "result": {
    "images": [{"url": "https://..."}]
  },
  "cost": 12,
  "ms": 8420
}
  • result contains the workflow’s output — image URLs, video URLs, or text, depending on what your workflow produces.
  • cost is the number of credits deducted from your balance for this run.
  • ms is the total server-side execution time in milliseconds.

​
Inspecting the input schema

Before building an integration, you can fetch the exact input fields a workflow expects: 
curl https://knouds.ai/api/workflows/your-workflow-slug/schema \
  -H "x-api-key: YOUR_API_KEY"
The response lists each field’s name, type, default value, and any allowed options — useful for dynamically building request bodies or validating inputs client-side.

​
Rate limits

Every response from the run endpoint includes rate limit headers so your integration can pace itself: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1714512000
X-RateLimit-Reset is a Unix epoch timestamp indicating when the current window resets. Limits by tier:
TierRequests per minute
Pro100
Business1,000
Enterpriseunlimited
Free and Creator tiers do not have external API access — only Pro+ keys are subject to (and reach) these limits. When you exceed the limit, the API returns 429 RATE_LIMIT_EXCEEDED with a Retry-After header (in seconds) telling you when to resume.

​
Sharing a workflow publicly

If you want to share a workflow so others can try it without authenticating, set publicPlayground: true on the workflow. This makes the schema available at the unauthenticated endpoint: 
GET https://knouds.ai/api/workflows/{slug}/public-schema
The public schema endpoint returns only the input field definitions — it does not expose nodes, edges, model configurations, or any internal details of your workflow. Callers still need a valid API key to actually run the workflow.