Skip to main content
Store or update chunks for a file on a branch.

Tool details

FieldValue
Nameupsert_file_chunks
GroupSearch

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project identifier or slug that scopes the tool call."
    },
    "branch_name": {
      "type": "string",
      "description": "Provide the branch name."
    },
    "file_path": {
      "type": "string",
      "description": "Provide the file path."
    },
    "chunks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "index": {
            "type": "number",
            "minimum": 0,
            "description": "Provide the index."
          },
          "content": {
            "type": "string",
            "minLength": 1,
            "description": "Source content or body supplied to the tool."
          },
          "start_offset": {
            "type": "number",
            "minimum": 0,
            "description": "Provide the start offset."
          },
          "end_offset": {
            "type": "number",
            "minimum": 0,
            "description": "Provide the end offset."
          },
          "token_count": {
            "type": "number",
            "minimum": 1,
            "description": "Provide the token count."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "description": "Additional structured values supplied to the tool."
            },
            "description": "Additional structured metadata for the request."
          }
        },
        "required": [
          "index",
          "content",
          "start_offset",
          "end_offset",
          "token_count"
        ],
        "additionalProperties": false,
        "description": "One chunk item supplied to the tool."
      },
      "minItems": 1,
      "maxItems": 500,
      "description": "Provide one or more chunk values."
    }
  },
  "required": [
    "project_reference",
    "branch_name",
    "file_path",
    "chunks"
  ],
  "additionalProperties": false,
  "description": "Input schema for the upsert_file_chunks tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "chunks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the returned record."
          },
          "index": {
            "type": "number",
            "description": "The index associated with this tool result."
          }
        },
        "required": [
          "id",
          "index"
        ],
        "additionalProperties": false,
        "description": "One chunk item associated with this tool result."
      },
      "description": "List of chunks associated with this tool result."
    },
    "created": {
      "type": "number",
      "description": "The created associated with this tool result."
    },
    "updated": {
      "type": "number",
      "description": "The updated associated with this tool result."
    }
  },
  "required": [
    "chunks",
    "created",
    "updated"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the upsert_file_chunks tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}