> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capedigital.co.ke/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow Engine

> Workflow definitions, nodes, transitions, and ticket management.

The central orchestration service. Manages workflow models, node definitions, transition rules, and the per-entity tickets that track each record's progress through a pipeline.

**Base URL:** `https://api.capedigital.co.ke/workflow`

## Key resources

| Resource    | Description                                                    |
| ----------- | -------------------------------------------------------------- |
| Workflows   | Workflow model definitions                                     |
| Nodes       | Individual stage nodes, gates, and their payload schemas       |
| Node Flows  | Directed edges between nodes                                   |
| Tickets     | Per-entity state tracking (one ticket per record per workflow) |
| Transitions | Advance a ticket from one node to the next                     |

## How it fits in CRM

Every lead and campaign in Commercial Service has a workflow ticket. Advancing a ticket (e.g. qualifying a lead, approving a booking) is done by POST-ing a transition to this service with the correct `action_id` and role.

<Note>
  See the **Workflow** tab in the top navigation for the full API reference.
</Note>