Workflows

const result = await client.fetchWorkflowCatalog({ bot_id: 'bot_abc123' });
console.log(result.response.catalog);

GET /v1/bot/workflow/catalog?project_id={project_id}&bot_id={bot_id}

const result = await client.fetchWorkflows({ bot_id: 'bot_abc123' });
console.log(result.response.workflows);

GET /v1/bot/workflow/readall?project_id={project_id}&bot_id={bot_id}

{
  "workflows": [
    {
      "uuid": "wf_abc123",
      "name": "Lead Qualification",
      "status": "active",
      "trigger": "webhook",
      "execution_count": 42,
      "last_run_at": "2026-05-01T09:00:00Z",
      "created_at": "2026-04-01T12:00:00Z"
    }
  ]
}

const result = await client.fetchWorkflow({
  bot_id: 'bot_abc123',
  workflow_id: 'wf_abc123'
});

GET /v1/bot/workflow/read?project_id={project_id}&bot_id={bot_id}&workflow_id={workflow_id}

// What is available for this agent
await client.fetchWorkflowTemplates({ bot_id: 'bot-id' });

// Create a workflow from one
await client.applyWorkflowTemplate({
  bot_id: 'bot-id',
  template_key: 'weekly-digest'
});

const result = await client.createWorkflow({
  bot_id: 'bot_abc123',
  name: 'Lead Qualification',
  description: 'Qualifies inbound leads and routes them',
  trigger: 'webhook',
  steps: [
    { type: 'prompt', content: 'Summarize the lead details' },
    { type: 'notify', channel: 'email', recipient: 'team@example.com' }
  ]
});

POST /v1/bot/workflow/create

const result = await client.updateWorkflow({
  bot_id: 'bot_abc123',
  workflow_id: 'wf_abc123',
  name: 'Updated Name',
  enabled: true
});

PUT /v1/bot/workflow/update

const result = await client.deleteWorkflow({
  bot_id: 'bot_abc123',
  workflow_id: 'wf_abc123'
});

DELETE /v1/bot/workflow/delete?project_id={project_id}&bot_id={bot_id}&workflow_id={workflow_id}

const result = await client.runWorkflow({
  bot_id: 'bot_abc123',
  workflow_id: 'wf_abc123'
});

console.log(result.response.execution);

POST /v1/bot/workflow/run

{
  "execution": {
    "uuid": "exec_xyz789",
    "workflow_id": "wf_abc123",
    "status": "completed",
    "duration_ms": 3240,
    "steps_completed": 2,
    "created_at": "2026-05-01T10:00:00Z"
  }
}

const result = await client.fetchWorkflowLogs({ bot_id: 'bot_abc123' });
console.log(result.response.logs);

GET /v1/bot/workflow/logs?project_id={project_id}&bot_id={bot_id}

{
  "logs": [
    {
      "uuid": "exec_xyz789",
      "workflow_id": "wf_abc123",
      "workflow_name": "Lead Qualification",
      "status": "completed",
      "duration_ms": 3240,
      "steps_completed": 2,
      "created_at": "2026-05-01T10:00:00Z"
    }
  ]
}