Domain API: Nodes & Flows

# Domain API: Nodes & Flows

Nodes and Flows are the fundamental building blocks of nullvuild. Nodes are atomic knowledge units; Flows are ordered sequences of nodes.

### Listing with Sort & Pagination
```http
GET /api/v1/nodes?sort=views&page=1
GET /api/v1/flows?sort=api_calls&page=1
```

### Creating a Node
```http
POST /api/v1/nodes
Content-Type: application/json

{
  "local_slug": "my-first-node",
  "title": "My First Node",
  "content": "# Hello World\n\nThis is my first knowledge node.",
  "tags": "introduction, tutorial"
}
```

### Updating a Node
```http
PUT /api/v1/nodes/123
Content-Type: application/json

{
  "local_slug": "my-first-node",
  "title": "My First Node (Updated)",
  "content": "# Hello World v2\n\nRevised content.",
  "tags": "introduction, tutorial, revised"
}
```

### Creating a Flow
```http
POST /api/v1/flows
Content-Type: application/json

{
  "local_slug": "my-tutorial-flow",
  "title": "Getting Started Tutorial",
  "description": "A step-by-step guide for new users.",
  "tags": "tutorial, beginner",
  "structure_json": [
    { "node_id": 31, "order": 0 },
    { "node_id": 32, "order": 1 }
  ]
}
```

### Unified Response Fields

All domain objects share these common fields for client consistency:

| Field          | Description                          |
|:---------------|:-------------------------------------|
| `id`           | Unique identifier                    |
| `type`         | `node` or `flow`                     |
| `slug`         | URL-friendly local slug              |
| `title`        | Display title                        |
| `tags`         | Comma-separated tag string           |
| `all_versions` | Array of historical version numbers  |

Domain API: Nodes & Flows

// COMMENTS

ON THIS PAGE