Skip to main content
POST
/
v1
/
boards
/
{boardId}
/
nodes
curl -X POST "https://api.chatgrid.ai/v1/boards/{boardId}/nodes" \
  -H "Authorization: Bearer cgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "youtube",
    "position": { "x": 0, "y": 0 },
    "data": {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "label": "Rick Astley - Never Gonna Give You Up"
    }
  }'
{
  "object": "node",
  "data": {
    "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "node_type": "youtube",
    "position_x": 0,
    "position_y": 0,
    "node_data": {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "label": "Rick Astley - Never Gonna Give You Up"
    },
    "parent_node_id": null,
    "created_at": "2026-03-15T10:31:00.000Z",
    "updated_at": "2026-03-15T10:31:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.chatgrid.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl -X POST "https://api.chatgrid.ai/v1/boards/{boardId}/nodes" \
  -H "Authorization: Bearer cgk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "youtube",
    "position": { "x": 0, "y": 0 },
    "data": {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "label": "Rick Astley - Never Gonna Give You Up"
    }
  }'
{
  "object": "node",
  "data": {
    "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "node_type": "youtube",
    "position_x": 0,
    "position_y": 0,
    "node_data": {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "label": "Rick Astley - Never Gonna Give You Up"
    },
    "parent_node_id": null,
    "created_at": "2026-03-15T10:31:00.000Z",
    "updated_at": "2026-03-15T10:31:00.000Z"
  }
}
YouTube and URL nodes auto-process. When you create a youtube or url node, the frontend automatically scrapes the content, extracts text, and vectorizes it for search. No extra API call needed.
For PDFs and images, upload the file first with Upload Asset, then create the node with the returned url as publicUrl and storagePath.