{
"organization_id": "uuid",
"statuses": [
{ "id": "status-open", "name": "OPEN", "color": "#3B82F6", "iconName": "circle", "isDefault": true, "order": 1 },
{ "id": "status-progress", "name": "IN_PROGRESS", "color": "#F59E0B", "iconName": "clock", "isDefault": false, "order": 2 },
{ "id": "status-resolved", "name": "RESOLVED", "color": "#10B981", "iconName": "check", "isDefault": false, "order": 3 }
],
"edges": [
{ "id": "edge-1", "source": "status-open", "target": "status-progress" },
{ "id": "edge-2", "source": "status-progress", "target": "status-resolved" }
]
}
{
"success": true,
"message": "Workflow saved successfully"
}
Boards
Save workflow
Replace the Kanban workflow configuration for an organization.
POST
/
boards
/
workflow
{
"organization_id": "uuid",
"statuses": [
{ "id": "status-open", "name": "OPEN", "color": "#3B82F6", "iconName": "circle", "isDefault": true, "order": 1 },
{ "id": "status-progress", "name": "IN_PROGRESS", "color": "#F59E0B", "iconName": "clock", "isDefault": false, "order": 2 },
{ "id": "status-resolved", "name": "RESOLVED", "color": "#10B981", "iconName": "check", "isDefault": false, "order": 3 }
],
"edges": [
{ "id": "edge-1", "source": "status-open", "target": "status-progress" },
{ "id": "edge-2", "source": "status-progress", "target": "status-resolved" }
]
}
{
"success": true,
"message": "Workflow saved successfully"
}
Atomically replaces the entire workflow configuration (statuses + transitions) for an organization.
Request body
string
required
UUID of the organization.
array
required
Array of status objects defining the Kanban columns.
Show Status fields
Show Status fields
string
required
Unique status key (e.g.,
status-open, status-review).string
required
Display name (e.g.,
OPEN, IN_PROGRESS, RESOLVED).string
required
Hex color code (e.g.,
#3B82F6).string
required
Icon name (e.g.,
circle, clock, check).boolean
required
Whether this is the default status for new tasks. Exactly one status must be
true.integer
required
Sort order (1-based).
integer
WIP limit (optional).
boolean
Whether new commenting is disabled in this status.
array
required
{
"organization_id": "uuid",
"statuses": [
{ "id": "status-open", "name": "OPEN", "color": "#3B82F6", "iconName": "circle", "isDefault": true, "order": 1 },
{ "id": "status-progress", "name": "IN_PROGRESS", "color": "#F59E0B", "iconName": "clock", "isDefault": false, "order": 2 },
{ "id": "status-resolved", "name": "RESOLVED", "color": "#10B981", "iconName": "check", "isDefault": false, "order": 3 }
],
"edges": [
{ "id": "edge-1", "source": "status-open", "target": "status-progress" },
{ "id": "edge-2", "source": "status-progress", "target": "status-resolved" }
]
}
{
"success": true,
"message": "Workflow saved successfully"
}
Was this page helpful?
⌘I