Workflows
Create, manage, and execute workflow compositions.
Workflows are named, versioned compositions of units forming complete auditable processes.
List Workflows
GET /api/v1/workflowsQuery Parameters
| Parameter | Type | Description |
|---|---|---|
domainId | string | Filter by domain |
status | string | Filter by status |
limit | number | Items per page (default: 20) |
offset | number | Pagination offset |
Get Workflow
GET /api/v1/workflows/{slug}Returns the full workflow definition including the unit DAG, typed I/O, and verification status.
Create Workflow
POST /api/v1/workflows| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Workflow name |
description | string | No | Brief description |
domainId | string | Yes | Domain ID |
units | array | Yes | Ordered list of unit IDs in the workflow |
jurisdiction | string | No | Jurisdiction scope |
AI-Assisted Composition
Let the AI compose a workflow from a natural language description:
POST /api/v1/workflows/compose| Field | Type | Required | Description |
|---|---|---|---|
description | string | Yes | What this workflow should accomplish |
domainId | string | Yes | Domain to search for units |
The AI will find matching units, chain them by typed I/O, and return a workflow draft.