BlockBatchCreate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ctlsurf-com/json-schema/ctlsurf-com-block-batch-create-schema.json",
  "title": "BlockBatchCreate",
  "description": "Insert blocks in order after a block (default: at the end of the page).",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ctlsurf-com-blocks-api-openapi.yml#/components/schemas/BlockBatchCreate",
  "properties": {
    "blocks": {
      "items": {
        "$ref": "#/$defs/BlockBatchItem"
      },
      "type": "array",
      "maxItems": 200,
      "minItems": 1,
      "title": "Blocks"
    },
    "after_block_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "title": "After Block Id"
    },
    "at_start": {
      "type": "boolean",
      "title": "At Start",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "blocks"
  ],
  "$defs": {
    "BlockBatchItem": {
      "properties": {
        "type": {
          "$ref": "#/$defs/BlockType"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Title"
        },
        "props": {
          "additionalProperties": true,
          "type": "object",
          "title": "Props",
          "default": {}
        }
      },
      "type": "object",
      "required": [
        "type"
      ],
      "title": "BlockBatchItem"
    },
    "BlockType": {
      "type": "string",
      "enum": [
        "text",
        "checklist",
        "table",
        "react_flow",
        "agent_control",
        "tree",
        "ctlsurf_task",
        "page_summary",
        "file",
        "mindmap",
        "datastore",
        "state",
        "log",
        "presentation"
      ],
      "title": "BlockType"
    }
  }
}