Endpoint
POST https://api.eachlabs.ai/v1/workflows
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable workflow name |
definition | object | No | Workflow definition with steps and input schema. Creates version v1 (or the name in definition.version) |
Definition Object
| Field | Type | Description |
|---|---|---|
steps | array | Steps to run; each needs a unique id. See workflow structure |
input_schema | object | Inputs under properties, each with type, required and an optional default_value |
metadata | object | Optional; metadata.output_mapping names values in the run’s workflow_output |
version | string | Optional name of the first version (default "v1") |
Code Examples
curl -X POST https://api.eachlabs.ai/v1/workflows \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Image Generator",
"definition": {
"input_schema": {
"properties": {
"prompt": { "type": "string", "required": true }
}
},
"steps": [
{
"id": "generate",
"type": "model",
"model": "nano-banana-2-text-to-image",
"params": { "prompt": "$.inputs.prompt", "aspect_ratio": "1:1" }
}
]
}
}'
import requests
response = requests.post(
"https://api.eachlabs.ai/v1/workflows",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"name": "Image Generator",
"definition": {
"input_schema": {
"properties": {"prompt": {"type": "string", "required": True}}
},
"steps": [
{
"id": "generate",
"type": "model",
"model": "nano-banana-2-text-to-image",
"params": {"prompt": "$.inputs.prompt", "aspect_ratio": "1:1"},
}
],
},
},
)
workflow = response.json()
print(f"Created: {workflow['workflow_id']}")
const response = await fetch("https://api.eachlabs.ai/v1/workflows", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
name: "Image Generator",
definition: {
input_schema: {
properties: { prompt: { type: "string", required: true } },
},
steps: [
{
id: "generate",
type: "model",
model: "nano-banana-2-text-to-image",
params: { prompt: "$.inputs.prompt", aspect_ratio: "1:1" },
},
],
},
}),
});
const workflow = await response.json();
console.log(`Created: ${workflow.workflow_id}`);
Response
Status:201 Created
{
"workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
"slug": "image-generator",
"name": "Image Generator",
"categories": ["general"],
"tags": null,
"status": "active",
"trigger_count": 0,
"clone_count": 0,
"is_public": false,
"production": false,
"created_at": "2025-12-01T10:00:00Z",
"updated_at": "2025-12-01T10:00:00Z",
"versions": [
{
"version_id": "v1",
"slug": "image-generator",
"published": true,
"locked": false,
"production": false,
"allowed_to_share": false,
"trigger_count": 0,
"created_at": "2025-12-01T10:00:00Z",
"updated_at": "2025-12-01T10:00:00Z",
"definition": {},
"status": "active"
}
]
}
Error Responses
| Status | Body | Description |
|---|---|---|
400 | {"error": "name is required"} | Missing required fields |
400 | {"error": "invalid argument"} | The definition failed validation. Send it to Create/Update Version to see the exact reason |
401 | {"error": "Invalid or missing API key"} | Authentication failure |