Bulk Operations

# Bulk Operations

Reduce network overhead by batching multiple operations into a single API call.

### Endpoint
```http
POST /api/v1/bulk
Content-Type: application/json
```

### Payload Structure
```json
{
  "ops": [
    {
      "action": "upsert_node",
      "data": {
        "local_slug": "node-a",
        "title": "Node A",
        "content": "# Content for Node A",
        "tags": "batch, demo"
      }
    },
    {
      "action": "upsert_node",
      "data": {
        "local_slug": "node-b",
        "title": "Node B",
        "content": "# Content for Node B",
        "tags": "batch, demo"
      }
    }
  ]
}
```

### Supported Actions

| Action         | Description                                      |
|:---------------|:-------------------------------------------------|
| `upsert_node`  | Create or update a node (matched by `local_slug`) |
| `upsert_flow`  | Create or update a flow                           |

### When to Use Bulk

- Synchronizing dozens of nodes from a local workspace in one request
- Restructuring a flow's entire node sequence atomically
- Initial workspace bootstrap when migrating from another system

> **Quota:** Each operation in the batch consumes your daily creation quota individually. A bulk request with 10 `upsert_node` operations uses 10 from your Node Creation balance (100/day default).

// COMMENTS

ON THIS PAGE