Workflows API Reference

https://api.stack0.dev/v1

curl -X POST https://api.stack0.dev/v1/workflows \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"projectSlug": "my-project", "slug": "my-workflow", "name": "My Workflow"}'

{
  "projectSlug": "my-project",
  "slug": "content-pipeline",
  "name": "Content Pipeline",
  "steps": [
    {
      "id": "step-1",
      "type": "llm",
      "name": "Generate",
      "provider": "anthropic",
      "model": "claude-3-5-sonnet-20241022",
      "prompt": "Write about {{topic}}"
    }
  ],
  "variables": {
    "topic": { "type": "string", "required": true }
  }
}

{
  "projectSlug": "my-project",
  "variables": {
    "topic": "AI in Healthcare"
  },
  "webhook": {
    "url": "https://yourapp.com/webhook",
    "secret": "your-secret"
  },
  "metadata": {
    "userId": "user_123"
  }
}

{
  "id": "run_xyz789",
  "workflowId": "workflow_abc123",
  "status": "pending",
  "variables": { "topic": "AI in Healthcare" },
  "metadata": { "userId": "user_123" },
  "totalSteps": 2,
  "completedSteps": 0,
  "createdAt": "2025-01-15T10:30:00Z"
}

{
  "id": "run_xyz789",
  "workflowId": "workflow_abc123",
  "status": "completed",
  "variables": { "topic": "AI in Healthcare" },
  "output": {
    "outline": "1. Introduction...",
    "content": "AI is transforming healthcare..."
  },
  "stepStates": {
    "generate-outline": {
      "status": "completed",
      "startedAt": "2025-01-15T10:30:01Z",
      "completedAt": "2025-01-15T10:30:05Z",
      "attempts": 1
    },
    "write-content": {
      "status": "completed",
      "startedAt": "2025-01-15T10:30:05Z",
      "completedAt": "2025-01-15T10:30:12Z",
      "attempts": 1
    }
  },
  "totalSteps": 2,
  "completedSteps": 2,
  "totalDurationMs": 11000,
  "creditsUsed": 15,
  "startedAt": "2025-01-15T10:30:01Z",
  "completedAt": "2025-01-15T10:30:12Z",
  "createdAt": "2025-01-15T10:30:00Z"
}