Chunking Endpoints Overview

​

What are Chunking Nodes?

• Split Documents: Break large documents into smaller text chunks
• Generate Embeddings: Create vector representations for similarity search
• Enable Retrieval: Make content searchable for RAG applications
• Optimize Performance: Balance chunk size and overlap for better retrieval

​

Available Endpoints

​

Chunking Node Structure

{
  "id": "chunking-1748287628685",
  "type": "chunking",
  "position": { "x": 300, "y": 200 },
  "data": {
    "name": "Document Chunking",
    "config": {
      "embeddingModel": "text-embedding-3-small",
      "chunkingSplitter": "character",
      "chunkSize": 1000,
      "chunkOverlap": 200,
      "chunkSeparator": "\n\n"
    },
    "result": {
      "updated": true,
      "processing": false,
      "has_error": false,
      "total_chunks": 420
    }
  }
}

​

Configuration Options

​

Embedding Models

• text-embedding-3-small: Fast, efficient embeddings
• text-embedding-3-large: High-quality embeddings
• colqwen: Multimodal embedding model

​

Splitter Types

• character: Split by character count (fast)
• token: Split by token count (language-aware)
• semantic: Split by semantic boundaries (high quality)
• element: Split by document elements

​

Key Parameters

• chunkSize: Characters or tokens per chunk (500-2000 recommended)
• chunkOverlap: Overlap between chunks (10-20% of chunk size)
• chunkSeparator: Text separator for splitting (default: “\n\n”)

​

Authentication

Authorization: Bearer YOUR_API_TOKEN

​

URL Structure

https://{flow_name}.flows.graphorlm.com/chunking[/{node_id}]

• {flow_name}: Your deployed flow name
• {node_id}: Specific chunking node ID (for updates)

​

Response Format

{
  "id": "string",
  "type": "chunking",
  "data": {
    "name": "string",
    "config": {
      "embeddingModel": "string",
      "chunkingSplitter": "string",
      "chunkSize": "number",
      "chunkOverlap": "number"
    },
    "result": {
      "updated": "boolean",
      "processing": "boolean",
      "has_error": "boolean",
      "total_chunks": "number"
    }
  }
}

​

Error Handling

{
  "detail": "Descriptive error message"
}

​

Next Steps