> ## Documentation Index
> Fetch the complete documentation index at: https://developer.surefeedback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Save workflow

> Replace the Kanban workflow configuration for an organization.

Atomically replaces the entire workflow configuration (statuses + transitions) for an organization.

## Request body

<ParamField body="organization_id" type="string" required>
  UUID of the organization.
</ParamField>

<ParamField body="statuses" type="array" required>
  Array of status objects defining the Kanban columns.

  <Expandable title="Status fields">
    <ParamField body="id" type="string" required>Unique status key (e.g., `status-open`, `status-review`).</ParamField>
    <ParamField body="name" type="string" required>Display name (e.g., `OPEN`, `IN_PROGRESS`, `RESOLVED`).</ParamField>
    <ParamField body="color" type="string" required>Hex color code (e.g., `#3B82F6`).</ParamField>
    <ParamField body="iconName" type="string" required>Icon name (e.g., `circle`, `clock`, `check`).</ParamField>
    <ParamField body="isDefault" type="boolean" required>Whether this is the default status for new tasks. Exactly one status must be `true`.</ParamField>
    <ParamField body="order" type="integer" required>Sort order (1-based).</ParamField>
    <ParamField body="limit" type="integer">WIP limit (optional).</ParamField>
    <ParamField body="commentingDisabled" type="boolean">Whether new commenting is disabled in this status.</ParamField>
  </Expandable>
</ParamField>

<ParamField body="edges" type="array" required>
  Array of allowed transitions between statuses.

  <Expandable title="Edge fields">
    <ParamField body="id" type="string" required>Unique edge key (e.g., `edge-1`). The API may normalise this to `e-{source}-{target}`.</ParamField>
    <ParamField body="source" type="string" required>The `id` of the origin status.</ParamField>
    <ParamField body="target" type="string" required>The `id` of the destination status.</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "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" }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Workflow saved successfully"
  }
  ```
</ResponseExample>