Create workflow

Create a draft workflow with an initial node. An omitted or empty name uses the default untitled name.

POST /api/v1/workflows

Permission: workflows:write. Write endpoints also require a workspace role that permits changes. See authentication and errors.

Request

curl --request POST 'https://app.innflow.ai/api/v1/workflows' \
  --header "Authorization: Bearer $INNFLOW_API_KEY" \
  --header "Idempotency-Key: unique-request-001" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Customer onboarding"
}'

Examples use placeholder IDs. Set INNFLOW_API_KEY in your shell and replace IDs with your own before sending a request.

Parameters

JSON body

Optional JSON body.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  }
}

Response

HTTP 201 — Returns data with id, name, icon, iconColor, deploymentStatus, deployedAt, createdAt and updatedAt.

See OpenAPI download for the machine-readable request contract and errors for errors and retry behavior.