Skip to main content

​
Endpoint

POST https://workflows.eachlabs.run/api/v1/workflows

​
Request Body

FieldTypeRequiredDescription
namestringYesHuman-readable workflow name
descriptionstringYesWhat the workflow does
categoriesstring[]NoCategory slugs for organization
lockedbooleanNoLock from modifications (default: false)
productionbooleanNoMark as production (default: false)
definitionobjectYesWorkflow definition with steps and input schema

​
Definition Object

FieldTypeDescription
versionstringVersion identifier (e.g., "v1")
stepsarrayArray of step definitions
input_schemaobjectJSON Schema for workflow inputs
metadataobjectAdditional metadata (e.g., output mapping)

​
Code Examples

curl -X POST https://workflows.eachlabs.run/api/v1/workflows \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "name": "Text to Image Generator",
    "description": "Generates images from text prompts using AI models",
    "categories": ["image-generation"],
    "definition": {
      "version": "v1",
      "input_schema": {
        "type": "object",
        "required": ["prompt"],
        "properties": {
          "prompt": {"type": "string", "description": "Text prompt"}
        }
      },
      "steps": [
        {
          "step_id": "generate",
          "type": "model",
          "model": "flux-1-1-pro",
          "params": {
            "prompt": "{{inputs.prompt}}"
          }
        }
      ]
    }
  }'

​
Response

Status: 201 Created 
{
  "workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
  "slug": "text-to-image-generator",
  "name": "Text to Image Generator",
  "description": "Generates images from text prompts using AI models",
  "categories": ["image-generation"],
  "locked": false,
  "production": false,
  "latest_version_id": "v1",
  "status": "active",
  "trigger_count": 0,
  "created_at": "2025-12-01T10:00:00Z",
  "updated_at": "2025-12-01T10:00:00Z",
  "versions": [
    {
      "version_id": "v1",
      "slug": "text-to-image-generator",
      "locked": false,
      "production": false,
      "trigger_count": 0,
      "status": "active"
    }
  ]
}

​
Error Responses

StatusBodyDescription
400{"error": "name is required"}Missing required fields
400{"error": "definition must include at least one step"}Empty steps array
401{"error": "Invalid or missing API key"}Authentication failure
Last modified on March 3, 2026