{
  "components": {
    "parameters": {
      "notionVersion": {
        "description": "The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`.",
        "in": "header",
        "name": "Notion-Version",
        "required": true,
        "schema": {
          "enum": [
            "2026-03-11"
          ]
        }
      }
    },
    "responses": {
      "error_api_400": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_400"
            }
          }
        },
        "description": ""
      },
      "error_api_401": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_401"
            }
          }
        },
        "description": ""
      },
      "error_api_403": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_403"
            }
          }
        },
        "description": ""
      },
      "error_api_404": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_404"
            }
          }
        },
        "description": ""
      },
      "error_api_406": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_406"
            }
          }
        },
        "description": ""
      },
      "error_api_409": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_409"
            }
          }
        },
        "description": ""
      },
      "error_api_429": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_429"
            }
          }
        },
        "description": ""
      },
      "error_api_500": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_500"
            }
          }
        },
        "description": ""
      },
      "error_api_503": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_503"
            }
          }
        },
        "description": ""
      },
      "error_api_504": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_504"
            }
          }
        },
        "description": ""
      },
      "error_api_529": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_api_529"
            }
          }
        },
        "description": ""
      },
      "error_oauth_400": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_oauth_400"
            }
          }
        },
        "description": ""
      },
      "error_oauth_401": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_oauth_401"
            }
          }
        },
        "description": ""
      },
      "error_oauth_403": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_oauth_403"
            }
          }
        },
        "description": ""
      },
      "error_oauth_500": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error_oauth_500"
            }
          }
        },
        "description": ""
      }
    },
    "schemas": {
      "CompatibleResponseapiColor": {
        "description": "One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`",
        "enum": [
          "default",
          "gray",
          "brown",
          "orange",
          "yellow",
          "green",
          "blue",
          "purple",
          "pink",
          "red",
          "default_background",
          "gray_background",
          "brown_background",
          "orange_background",
          "yellow_background",
          "green_background",
          "blue_background",
          "purple_background",
          "pink_background",
          "red_background"
        ],
        "type": "string"
      },
      "CompatibleResponseemojiRequest": {
        "example": "😀",
        "type": "string"
      },
      "CompatibleResponseemptyObject": {
        "additionalProperties": true,
        "properties": {},
        "type": "object"
      },
      "CompatibleResponseidRequest": {
        "type": "string"
      },
      "CompatibleResponselanguageRequest": {
        "enum": [
          "abap",
          "abc",
          "agda",
          "arduino",
          "ascii art",
          "assembly",
          "bash",
          "basic",
          "bnf",
          "c",
          "c#",
          "c++",
          "clojure",
          "coffeescript",
          "coq",
          "css",
          "dart",
          "dhall",
          "diff",
          "docker",
          "ebnf",
          "elixir",
          "elm",
          "erlang",
          "f#",
          "flow",
          "fortran",
          "gherkin",
          "glsl",
          "go",
          "graphql",
          "groovy",
          "haskell",
          "hcl",
          "html",
          "idris",
          "java",
          "javascript",
          "json",
          "julia",
          "kotlin",
          "latex",
          "less",
          "lisp",
          "livescript",
          "llvm ir",
          "lua",
          "makefile",
          "markdown",
          "markup",
          "matlab",
          "mathematica",
          "mermaid",
          "nix",
          "notion formula",
          "objective-c",
          "ocaml",
          "pascal",
          "perl",
          "php",
          "plain text",
          "powershell",
          "prolog",
          "protobuf",
          "purescript",
          "python",
          "r",
          "racket",
          "reason",
          "ruby",
          "rust",
          "sass",
          "scala",
          "scheme",
          "scss",
          "shell",
          "smalltalk",
          "solidity",
          "sql",
          "swift",
          "toml",
          "typescript",
          "vb.net",
          "verilog",
          "vhdl",
          "visual basic",
          "webassembly",
          "xml",
          "yaml",
          "java/c/c++/c#"
        ],
        "type": "string"
      },
      "CompatibleResponsenoticonColor": {
        "description": "One of: `gray`, `lightgray`, `brown`, `yellow`, `orange`, `green`, `blue`, `purple`, `pink`, `red`",
        "enum": [
          "gray",
          "lightgray",
          "brown",
          "yellow",
          "orange",
          "green",
          "blue",
          "purple",
          "pink",
          "red"
        ],
        "type": "string"
      },
      "CompatibleResponsenoticonName": {
        "examples": [
          "pizza",
          "meeting",
          "home",
          "star",
          "robot"
        ],
        "type": "string"
      },
      "CompatibleResponsenumberFormat": {
        "example": "number",
        "type": "string"
      },
      "CompatibleResponsepropertyDescriptionRequest": {
        "maxLength": 280,
        "minLength": 1,
        "type": "string"
      },
      "CompatibleResponserelationItemPropertyValueResponse": {
        "properties": {
          "id": {
            "$ref": "#/components/schemas/CompatibleResponseidRequest"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "CompatibleResponserollupFunction": {
        "enum": [
          "count",
          "count_values",
          "empty",
          "not_empty",
          "unique",
          "show_unique",
          "percent_empty",
          "percent_not_empty",
          "sum",
          "average",
          "median",
          "min",
          "max",
          "range",
          "earliest_date",
          "latest_date",
          "date_range",
          "checked",
          "unchecked",
          "percent_checked",
          "percent_unchecked",
          "count_per_group",
          "percent_per_group",
          "show_original"
        ],
        "type": "string"
      },
      "CompatibleResponseselectColor": {
        "description": "One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`",
        "enum": [
          "default",
          "gray",
          "brown",
          "orange",
          "yellow",
          "green",
          "blue",
          "purple",
          "pink",
          "red"
        ],
        "type": "string"
      },
      "CompatibleResponsetextRequest": {
        "maxLength": 2000,
        "minLength": 1,
        "type": "string"
      },
      "CompatibleResponsetimeZoneRequest": {
        "example": "Africa/Abidjan",
        "type": "string"
      },
      "agentIdParentForBlockBasedObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "agent_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent agent."
          },
          "type": {
            "const": "agent_id",
            "description": "The parent type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "agent_id"
        ],
        "type": "object"
      },
      "annotationRequest": {
        "properties": {
          "bold": {
            "description": "Whether the text is formatted as bold.",
            "type": "boolean"
          },
          "code": {
            "description": "Whether the text is formatted as code.",
            "type": "boolean"
          },
          "color": {
            "$ref": "#/components/schemas/apiColor",
            "description": "The color of the text."
          },
          "italic": {
            "description": "Whether the text is formatted as italic.",
            "type": "boolean"
          },
          "strikethrough": {
            "description": "Whether the text is formatted with a strikethrough.",
            "type": "boolean"
          },
          "underline": {
            "description": "Whether the text is formatted with an underline.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "annotationResponse": {
        "additionalProperties": true,
        "properties": {
          "bold": {
            "type": "boolean"
          },
          "code": {
            "type": "boolean"
          },
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseapiColor"
          },
          "italic": {
            "type": "boolean"
          },
          "strikethrough": {
            "type": "boolean"
          },
          "underline": {
            "type": "boolean"
          }
        },
        "required": [
          "bold",
          "italic",
          "strikethrough",
          "underline",
          "code",
          "color"
        ],
        "type": "object"
      },
      "apiColor": {
        "description": "One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`",
        "enum": [
          "default",
          "gray",
          "brown",
          "orange",
          "yellow",
          "green",
          "blue",
          "purple",
          "pink",
          "red",
          "default_background",
          "gray_background",
          "brown_background",
          "orange_background",
          "yellow_background",
          "green_background",
          "blue_background",
          "purple_background",
          "pink_background",
          "red_background"
        ],
        "type": "string"
      },
      "apiTranscriptionStatus": {
        "enum": [
          "transcription_not_started",
          "transcription_paused",
          "transcription_in_progress",
          "transcription_failed",
          "summary_in_progress",
          "notes_ready"
        ],
        "type": "string"
      },
      "arrayBasedPropertyValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/titleArrayBasedPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/richTextArrayBasedPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/peopleArrayBasedPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/relationArrayBasedPropertyValueResponse"
          }
        ]
      },
      "arrayPartialRollupValueResponse": {
        "properties": {
          "array": {
            "items": {
              "$ref": "#/components/schemas/simpleOrArrayPropertyValueResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "array",
            "description": "Always `array`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "array"
        ],
        "title": "Array",
        "type": "object"
      },
      "asyncTaskMcpOperationName": {
        "enum": [
          "create_pages",
          "update_page"
        ],
        "type": "string"
      },
      "asyncTaskRestOperationName": {
        "enum": [
          "POST /v1/pages",
          "PATCH /v1/pages/:page_id/markdown"
        ],
        "type": "string"
      },
      "audioBlockObjectResponse": {
        "properties": {
          "audio": {
            "$ref": "#/components/schemas/mediaContentWithFileAndCaptionResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "audio",
            "type": "string"
          }
        },
        "required": [
          "type",
          "audio",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Audio",
        "type": "object"
      },
      "baseWebhookPayload": {
        "properties": {
          "accessible_by": {
            "description": "The users or bots who own the bot connection to the `integration_id` and have access to the webhook's `entity`. Only present for public integrations.",
            "items": {
              "oneOf": [
                {
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "$ref": "#/components/schemas/idResponse",
                      "description": "The ID of the user."
                    },
                    "type": {
                      "const": "person",
                      "description": "Always `person`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "type": "object"
                },
                {
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "$ref": "#/components/schemas/idResponse",
                      "description": "The ID of the bot."
                    },
                    "type": {
                      "const": "bot",
                      "description": "Always `bot`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "type": "object"
                }
              ]
            },
            "maxItems": 100,
            "type": "array"
          },
          "api_version": {
            "description": "The Notion API version that was used to render this webhook event's shape.",
            "enum": [
              "2022-06-28",
              "2025-09-03",
              "2026-03-11"
            ],
            "type": "string"
          },
          "attempt_number": {
            "description": "The delivery attempt number (1-8) of the current event delivery.",
            "type": "integer"
          },
          "authors": {
            "description": "The users or bots that performed the action. Typically an array of length 1; can be more for aggregated events.",
            "items": {
              "oneOf": [
                {
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "$ref": "#/components/schemas/idResponse",
                      "description": "The ID of the user."
                    },
                    "type": {
                      "const": "person",
                      "description": "Always `person`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "type": "object"
                },
                {
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "$ref": "#/components/schemas/idResponse",
                      "description": "The ID of the bot."
                    },
                    "type": {
                      "const": "bot",
                      "description": "Always `bot`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "type": "object"
                }
              ]
            },
            "maxItems": 100,
            "type": "array"
          },
          "id": {
            "description": "Unique identifier for this webhook event.",
            "type": "string"
          },
          "integration_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the integration the subscription is set up with."
          },
          "subscription_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the webhook subscription."
          },
          "timestamp": {
            "description": "ISO 8601 timestamp of when the event occurred. Can be used to order events.",
            "type": "string"
          },
          "workspace_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the workspace where the event originated."
          },
          "workspace_name": {
            "description": "The name of the workspace where the event originated.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "timestamp",
          "workspace_id",
          "workspace_name",
          "subscription_id",
          "integration_id",
          "authors",
          "attempt_number",
          "api_version"
        ],
        "type": "object"
      },
      "blockIdCommentParentResponse": {
        "additionalProperties": true,
        "properties": {
          "block_id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "type": {
            "const": "block_id",
            "description": "Always `block_id`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "block_id"
        ],
        "title": "Block Id",
        "type": "object"
      },
      "blockIdParentForBlockBasedObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "block_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent block."
          },
          "type": {
            "const": "block_id",
            "description": "The parent type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "block_id"
        ],
        "type": "object"
      },
      "blockObjectRequest": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "embed": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
                  },
                  {
                    "$ref": "#/components/schemas/embedFileUploadRequest"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "embed",
                "type": "string"
              }
            },
            "required": [
              "embed"
            ],
            "title": "Embed",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bookmark": {
                "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bookmark",
                "type": "string"
              }
            },
            "required": [
              "bookmark"
            ],
            "title": "Bookmark",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "image": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "image",
                "type": "string"
              }
            },
            "required": [
              "image"
            ],
            "title": "Image",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "video",
                "type": "string"
              },
              "video": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              }
            },
            "required": [
              "video"
            ],
            "title": "Video",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "pdf": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "type": {
                "const": "pdf",
                "type": "string"
              }
            },
            "required": [
              "pdf"
            ],
            "title": "Pdf",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "file": {
                "$ref": "#/components/schemas/mediaContentWithFileNameAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "file",
                "type": "string"
              }
            },
            "required": [
              "file"
            ],
            "title": "File",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "audio": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "audio",
                "type": "string"
              }
            },
            "required": [
              "audio"
            ],
            "title": "Audio",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "additionalProperties": false,
                "properties": {
                  "caption": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "language": {
                    "$ref": "#/components/schemas/languageRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text",
                  "language"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "code",
                "type": "string"
              }
            },
            "required": [
              "code"
            ],
            "title": "Code",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "equation": {
                "$ref": "#/components/schemas/contentWithExpressionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "equation",
                "type": "string"
              }
            },
            "required": [
              "equation"
            ],
            "title": "Equation",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "divider": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "divider",
                "type": "string"
              }
            },
            "required": [
              "divider"
            ],
            "title": "Divider",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "breadcrumb": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "breadcrumb",
                "type": "string"
              }
            },
            "required": [
              "breadcrumb"
            ],
            "title": "Breadcrumb",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "tab": {
                "$ref": "#/components/schemas/tabRequestWithNestedTabItemChildren"
              },
              "type": {
                "const": "tab",
                "type": "string"
              }
            },
            "required": [
              "tab"
            ],
            "title": "Tab",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_of_contents": {
                "additionalProperties": false,
                "properties": {
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "table_of_contents",
                "type": "string"
              }
            },
            "required": [
              "table_of_contents"
            ],
            "title": "Table Of Contents",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "link_to_page": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "page_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "page_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "page_id"
                    ],
                    "title": "Page Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "database_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "database_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "database_id"
                    ],
                    "title": "Database Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "comment_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "comment_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "comment_id"
                    ],
                    "title": "Comment Id",
                    "type": "object"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "link_to_page",
                "type": "string"
              }
            },
            "required": [
              "link_to_page"
            ],
            "title": "Link To Page",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_row": {
                "$ref": "#/components/schemas/contentWithTableRowRequest"
              },
              "type": {
                "const": "table_row",
                "type": "string"
              }
            },
            "required": [
              "table_row"
            ],
            "title": "Table Row",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table": {
                "$ref": "#/components/schemas/tableRequestWithTableRowChildren"
              },
              "type": {
                "const": "table",
                "type": "string"
              }
            },
            "required": [
              "table"
            ],
            "title": "Table",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "column_list": {
                "$ref": "#/components/schemas/columnListRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "column_list",
                "type": "string"
              }
            },
            "required": [
              "column_list"
            ],
            "title": "Column List",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "column": {
                "$ref": "#/components/schemas/columnWithChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "column",
                "type": "string"
              }
            },
            "required": [
              "column"
            ],
            "title": "Column",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_1": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "is_toggleable": {
                    "type": "boolean"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_1",
                "type": "string"
              }
            },
            "required": [
              "heading_1"
            ],
            "title": "Heading 1",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_2": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "is_toggleable": {
                    "type": "boolean"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_2",
                "type": "string"
              }
            },
            "required": [
              "heading_2"
            ],
            "title": "Heading 2",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_3": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "is_toggleable": {
                    "type": "boolean"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_3",
                "type": "string"
              }
            },
            "required": [
              "heading_3"
            ],
            "title": "Heading 3",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_4": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "is_toggleable": {
                    "type": "boolean"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_4",
                "type": "string"
              }
            },
            "required": [
              "heading_4"
            ],
            "title": "Heading 4",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "paragraph": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "paragraph",
                "type": "string"
              }
            },
            "required": [
              "paragraph"
            ],
            "title": "Paragraph",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bulleted_list_item": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bulleted_list_item",
                "type": "string"
              }
            },
            "required": [
              "bulleted_list_item"
            ],
            "title": "Bulleted List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "numbered_list_item": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "numbered_list_item",
                "type": "string"
              }
            },
            "required": [
              "numbered_list_item"
            ],
            "title": "Numbered List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "quote": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "quote",
                "type": "string"
              }
            },
            "required": [
              "quote"
            ],
            "title": "Quote",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "to_do": {
                "additionalProperties": false,
                "properties": {
                  "checked": {
                    "type": "boolean"
                  },
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "to_do",
                "type": "string"
              }
            },
            "required": [
              "to_do"
            ],
            "title": "To Do",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "toggle": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "toggle",
                "type": "string"
              }
            },
            "required": [
              "toggle"
            ],
            "title": "Toggle",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "template": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "template",
                "type": "string"
              }
            },
            "required": [
              "template"
            ],
            "title": "Template",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "callout": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "callout",
                "type": "string"
              }
            },
            "required": [
              "callout"
            ],
            "title": "Callout",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "synced_block": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "synced_from": {
                    "additionalProperties": false,
                    "properties": {
                      "block_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "block_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "block_id"
                    ],
                    "title": "Block Id",
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "synced_from"
                ],
                "type": "object"
              },
              "type": {
                "const": "synced_block",
                "type": "string"
              }
            },
            "required": [
              "synced_block"
            ],
            "title": "Synced Block",
            "type": "object"
          }
        ]
      },
      "blockObjectRequestWithoutChildren": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "embed": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
                  },
                  {
                    "$ref": "#/components/schemas/embedFileUploadRequest"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "embed",
                "type": "string"
              }
            },
            "required": [
              "embed"
            ],
            "title": "Embed",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bookmark": {
                "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bookmark",
                "type": "string"
              }
            },
            "required": [
              "bookmark"
            ],
            "title": "Bookmark",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "image": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "image",
                "type": "string"
              }
            },
            "required": [
              "image"
            ],
            "title": "Image",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "video",
                "type": "string"
              },
              "video": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              }
            },
            "required": [
              "video"
            ],
            "title": "Video",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "pdf": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "type": {
                "const": "pdf",
                "type": "string"
              }
            },
            "required": [
              "pdf"
            ],
            "title": "Pdf",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "file": {
                "$ref": "#/components/schemas/mediaContentWithFileNameAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "file",
                "type": "string"
              }
            },
            "required": [
              "file"
            ],
            "title": "File",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "audio": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "audio",
                "type": "string"
              }
            },
            "required": [
              "audio"
            ],
            "title": "Audio",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "additionalProperties": false,
                "properties": {
                  "caption": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "language": {
                    "$ref": "#/components/schemas/languageRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text",
                  "language"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "code",
                "type": "string"
              }
            },
            "required": [
              "code"
            ],
            "title": "Code",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "equation": {
                "$ref": "#/components/schemas/contentWithExpressionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "equation",
                "type": "string"
              }
            },
            "required": [
              "equation"
            ],
            "title": "Equation",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "divider": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "divider",
                "type": "string"
              }
            },
            "required": [
              "divider"
            ],
            "title": "Divider",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "breadcrumb": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "breadcrumb",
                "type": "string"
              }
            },
            "required": [
              "breadcrumb"
            ],
            "title": "Breadcrumb",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "tab": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "type": {
                "const": "tab",
                "type": "string"
              }
            },
            "required": [
              "tab"
            ],
            "title": "Tab",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_of_contents": {
                "additionalProperties": false,
                "properties": {
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "table_of_contents",
                "type": "string"
              }
            },
            "required": [
              "table_of_contents"
            ],
            "title": "Table Of Contents",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "link_to_page": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "page_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "page_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "page_id"
                    ],
                    "title": "Page Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "database_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "database_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "database_id"
                    ],
                    "title": "Database Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "comment_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "comment_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "comment_id"
                    ],
                    "title": "Comment Id",
                    "type": "object"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "link_to_page",
                "type": "string"
              }
            },
            "required": [
              "link_to_page"
            ],
            "title": "Link To Page",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_row": {
                "$ref": "#/components/schemas/contentWithTableRowRequest"
              },
              "type": {
                "const": "table_row",
                "type": "string"
              }
            },
            "required": [
              "table_row"
            ],
            "title": "Table Row",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_1": {
                "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_1",
                "type": "string"
              }
            },
            "required": [
              "heading_1"
            ],
            "title": "Heading 1",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_2": {
                "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_2",
                "type": "string"
              }
            },
            "required": [
              "heading_2"
            ],
            "title": "Heading 2",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_3": {
                "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_3",
                "type": "string"
              }
            },
            "required": [
              "heading_3"
            ],
            "title": "Heading 3",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_4": {
                "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_4",
                "type": "string"
              }
            },
            "required": [
              "heading_4"
            ],
            "title": "Heading 4",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "paragraph": {
                "$ref": "#/components/schemas/contentWithRichTextColorAndIconRequest"
              },
              "type": {
                "const": "paragraph",
                "type": "string"
              }
            },
            "required": [
              "paragraph"
            ],
            "title": "Paragraph",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bulleted_list_item": {
                "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bulleted_list_item",
                "type": "string"
              }
            },
            "required": [
              "bulleted_list_item"
            ],
            "title": "Bulleted List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "numbered_list_item": {
                "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "numbered_list_item",
                "type": "string"
              }
            },
            "required": [
              "numbered_list_item"
            ],
            "title": "Numbered List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "quote": {
                "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
              },
              "type": {
                "const": "quote",
                "type": "string"
              }
            },
            "required": [
              "quote"
            ],
            "title": "Quote",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "to_do": {
                "additionalProperties": false,
                "properties": {
                  "checked": {
                    "type": "boolean"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "to_do",
                "type": "string"
              }
            },
            "required": [
              "to_do"
            ],
            "title": "To Do",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "toggle": {
                "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
              },
              "type": {
                "const": "toggle",
                "type": "string"
              }
            },
            "required": [
              "toggle"
            ],
            "title": "Toggle",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "template": {
                "$ref": "#/components/schemas/contentWithRichTextRequest"
              },
              "type": {
                "const": "template",
                "type": "string"
              }
            },
            "required": [
              "template"
            ],
            "title": "Template",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "callout": {
                "additionalProperties": false,
                "properties": {
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "callout",
                "type": "string"
              }
            },
            "required": [
              "callout"
            ],
            "title": "Callout",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "synced_block": {
                "additionalProperties": false,
                "properties": {
                  "synced_from": {
                    "additionalProperties": false,
                    "properties": {
                      "block_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "block_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "block_id"
                    ],
                    "title": "Block Id",
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "synced_from"
                ],
                "type": "object"
              },
              "type": {
                "const": "synced_block",
                "type": "string"
              }
            },
            "required": [
              "synced_block"
            ],
            "title": "Synced Block",
            "type": "object"
          }
        ]
      },
      "blockObjectResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/paragraphBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/heading1BlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/heading2BlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/heading3BlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/heading4BlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/bulletedListItemBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/numberedListItemBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/quoteBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/toDoBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/toggleBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/templateBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/syncedBlockBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/childPageBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/childDatabaseBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/equationBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/codeBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/calloutBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/dividerBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/breadcrumbBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/tableOfContentsBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/tabBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/columnListBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/columnBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/linkToPageBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/tableBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/tableRowBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/meetingNotesBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/embedBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/bookmarkBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/imageBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/videoBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/pdfBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/fileBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/audioBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/linkPreviewBlockObjectResponse"
          },
          {
            "$ref": "#/components/schemas/unsupportedBlockObjectResponse"
          }
        ]
      },
      "blockObjectWithSingleLevelOfChildrenRequest": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "embed": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
                  },
                  {
                    "$ref": "#/components/schemas/embedFileUploadRequest"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "embed",
                "type": "string"
              }
            },
            "required": [
              "embed"
            ],
            "title": "Embed",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bookmark": {
                "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bookmark",
                "type": "string"
              }
            },
            "required": [
              "bookmark"
            ],
            "title": "Bookmark",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "image": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "image",
                "type": "string"
              }
            },
            "required": [
              "image"
            ],
            "title": "Image",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "video",
                "type": "string"
              },
              "video": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              }
            },
            "required": [
              "video"
            ],
            "title": "Video",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "pdf": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "type": {
                "const": "pdf",
                "type": "string"
              }
            },
            "required": [
              "pdf"
            ],
            "title": "Pdf",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "file": {
                "$ref": "#/components/schemas/mediaContentWithFileNameAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "file",
                "type": "string"
              }
            },
            "required": [
              "file"
            ],
            "title": "File",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "audio": {
                "$ref": "#/components/schemas/mediaContentWithFileAndCaptionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "audio",
                "type": "string"
              }
            },
            "required": [
              "audio"
            ],
            "title": "Audio",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "additionalProperties": false,
                "properties": {
                  "caption": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "language": {
                    "$ref": "#/components/schemas/languageRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text",
                  "language"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "code",
                "type": "string"
              }
            },
            "required": [
              "code"
            ],
            "title": "Code",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "equation": {
                "$ref": "#/components/schemas/contentWithExpressionRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "equation",
                "type": "string"
              }
            },
            "required": [
              "equation"
            ],
            "title": "Equation",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "divider": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "divider",
                "type": "string"
              }
            },
            "required": [
              "divider"
            ],
            "title": "Divider",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "breadcrumb": {
                "$ref": "#/components/schemas/emptyObject"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "breadcrumb",
                "type": "string"
              }
            },
            "required": [
              "breadcrumb"
            ],
            "title": "Breadcrumb",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "tab": {
                "$ref": "#/components/schemas/tabRequestWithTabItemChildren"
              },
              "type": {
                "const": "tab",
                "type": "string"
              }
            },
            "required": [
              "tab"
            ],
            "title": "Tab",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_of_contents": {
                "additionalProperties": false,
                "properties": {
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "table_of_contents",
                "type": "string"
              }
            },
            "required": [
              "table_of_contents"
            ],
            "title": "Table Of Contents",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "link_to_page": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "page_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "page_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "page_id"
                    ],
                    "title": "Page Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "database_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "database_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "database_id"
                    ],
                    "title": "Database Id",
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "comment_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "comment_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "comment_id"
                    ],
                    "title": "Comment Id",
                    "type": "object"
                  }
                ]
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "link_to_page",
                "type": "string"
              }
            },
            "required": [
              "link_to_page"
            ],
            "title": "Link To Page",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table_row": {
                "$ref": "#/components/schemas/contentWithTableRowRequest"
              },
              "type": {
                "const": "table_row",
                "type": "string"
              }
            },
            "required": [
              "table_row"
            ],
            "title": "Table Row",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_1": {
                "$ref": "#/components/schemas/headerContentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_1",
                "type": "string"
              }
            },
            "required": [
              "heading_1"
            ],
            "title": "Heading 1",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_2": {
                "$ref": "#/components/schemas/headerContentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_2",
                "type": "string"
              }
            },
            "required": [
              "heading_2"
            ],
            "title": "Heading 2",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_3": {
                "$ref": "#/components/schemas/headerContentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_3",
                "type": "string"
              }
            },
            "required": [
              "heading_3"
            ],
            "title": "Heading 3",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "heading_4": {
                "$ref": "#/components/schemas/headerContentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "heading_4",
                "type": "string"
              }
            },
            "required": [
              "heading_4"
            ],
            "title": "Heading 4",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "paragraph": {
                "$ref": "#/components/schemas/paragraphWithSingleLevelOfChildrenRequest"
              },
              "type": {
                "const": "paragraph",
                "type": "string"
              }
            },
            "required": [
              "paragraph"
            ],
            "title": "Paragraph",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "bulleted_list_item": {
                "$ref": "#/components/schemas/contentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "bulleted_list_item",
                "type": "string"
              }
            },
            "required": [
              "bulleted_list_item"
            ],
            "title": "Bulleted List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "numbered_list_item": {
                "$ref": "#/components/schemas/contentWithSingleLevelOfChildrenRequest"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "numbered_list_item",
                "type": "string"
              }
            },
            "required": [
              "numbered_list_item"
            ],
            "title": "Numbered List Item",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "quote": {
                "$ref": "#/components/schemas/contentWithSingleLevelOfChildrenRequest"
              },
              "type": {
                "const": "quote",
                "type": "string"
              }
            },
            "required": [
              "quote"
            ],
            "title": "Quote",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "table": {
                "$ref": "#/components/schemas/tableRequestWithTableRowChildren"
              },
              "type": {
                "const": "table",
                "type": "string"
              }
            },
            "required": [
              "table"
            ],
            "title": "Table",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "to_do": {
                "additionalProperties": false,
                "properties": {
                  "checked": {
                    "type": "boolean"
                  },
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "to_do",
                "type": "string"
              }
            },
            "required": [
              "to_do"
            ],
            "title": "To Do",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "toggle": {
                "$ref": "#/components/schemas/contentWithSingleLevelOfChildrenRequest"
              },
              "type": {
                "const": "toggle",
                "type": "string"
              }
            },
            "required": [
              "toggle"
            ],
            "title": "Toggle",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "template": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "type": {
                "const": "template",
                "type": "string"
              }
            },
            "required": [
              "template"
            ],
            "title": "Template",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "callout": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "color": {
                    "$ref": "#/components/schemas/apiColor"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest"
                  },
                  "rich_text": {
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "type": "object"
              },
              "object": {
                "const": "block",
                "type": "string"
              },
              "type": {
                "const": "callout",
                "type": "string"
              }
            },
            "required": [
              "callout"
            ],
            "title": "Callout",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "object": {
                "const": "block",
                "type": "string"
              },
              "synced_block": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "synced_from": {
                    "additionalProperties": false,
                    "properties": {
                      "block_id": {
                        "$ref": "#/components/schemas/idRequest"
                      },
                      "type": {
                        "const": "block_id",
                        "type": "string"
                      }
                    },
                    "required": [
                      "block_id"
                    ],
                    "title": "Block Id",
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "synced_from"
                ],
                "type": "object"
              },
              "type": {
                "const": "synced_block",
                "type": "string"
              }
            },
            "required": [
              "synced_block"
            ],
            "title": "Synced Block",
            "type": "object"
          }
        ]
      },
      "boardViewConfigRequest": {
        "properties": {
          "card_layout": {
            "description": "Card layout mode. \"list\" shows full cards, \"compact\" shows condensed cards. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `list`, `compact`",
                "enum": [
                  "list",
                  "compact"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover": {
            "description": "Cover image configuration for cards. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/coverConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover_aspect": {
            "description": "Aspect ratio mode for cover images. \"contain\" fits the image, \"cover\" fills the area. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `contain`, `cover`",
                "enum": [
                  "contain",
                  "cover"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover_size": {
            "description": "Size of the cover image on cards. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `small`, `medium`, `large`",
                "enum": [
                  "small",
                  "medium",
                  "large"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "group_by": {
            "$ref": "#/components/schemas/groupByConfigRequest",
            "description": "Group-by configuration for board columns."
          },
          "properties": {
            "description": "Property visibility and display configuration on cards. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "sub_group_by": {
            "description": "Secondary group-by configuration for sub-grouping within columns. Pass null to remove sub-grouping.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "board",
            "description": "The view type. Must be \"board\".",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by"
        ],
        "type": "object"
      },
      "boardViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "card_layout": {
            "description": "Card layout mode (list shows all properties, compact shows inline).",
            "enum": [
              "list",
              "compact"
            ],
            "type": "string"
          },
          "cover": {
            "$ref": "#/components/schemas/coverConfigResponse",
            "description": "Card cover/preview image configuration."
          },
          "cover_aspect": {
            "description": "Cover image aspect ratio.",
            "enum": [
              "contain",
              "cover"
            ],
            "type": "string"
          },
          "cover_size": {
            "description": "Cover image size.",
            "enum": [
              "small",
              "medium",
              "large"
            ],
            "type": "string"
          },
          "group_by": {
            "$ref": "#/components/schemas/groupByConfigResponse",
            "description": "Column (horizontal) grouping - required for board view."
          },
          "properties": {
            "description": "Properties to display on each card.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "sub_group_by": {
            "$ref": "#/components/schemas/groupByConfigResponse",
            "description": "Sub-grouping (vertical swimlanes within columns)."
          },
          "type": {
            "const": "board",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by"
        ],
        "type": "object"
      },
      "bookmarkBlockObjectResponse": {
        "properties": {
          "bookmark": {
            "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "bookmark",
            "type": "string"
          }
        },
        "required": [
          "type",
          "bookmark",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Bookmark",
        "type": "object"
      },
      "booleanFormulaPropertyResponse": {
        "properties": {
          "boolean": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "type": {
            "const": "boolean",
            "type": "string"
          }
        },
        "required": [
          "type",
          "boolean"
        ],
        "title": "Boolean",
        "type": "object"
      },
      "booleanFormulaPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "boolean": {
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "boolean",
            "description": "Always `boolean`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "boolean"
        ],
        "title": "Boolean",
        "type": "object"
      },
      "botInfoResponse": {
        "additionalProperties": true,
        "properties": {
          "owner": {
            "description": "Details about the owner of the bot.",
            "oneOf": [
              {
                "additionalProperties": true,
                "properties": {
                  "type": {
                    "const": "user",
                    "description": "Always `user`",
                    "type": "string"
                  },
                  "user": {
                    "description": "Details about the owner of the bot, when the `type` of the owner is `user`. This means the bot is for a integration.",
                    "oneOf": [
                      {
                        "additionalProperties": true,
                        "properties": {
                          "avatar_url": {
                            "description": "The avatar URL of the user.",
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "id": {
                            "$ref": "#/components/schemas/idResponse",
                            "description": "The ID of the user."
                          },
                          "name": {
                            "description": "The name of the user.",
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "object": {
                            "const": "user",
                            "description": "The user object type name.",
                            "type": "string"
                          },
                          "person": {
                            "additionalProperties": true,
                            "description": "The person info of the user.",
                            "properties": {
                              "email": {
                                "description": "The email of the person.",
                                "type": "string"
                              },
                              "email_verified": {
                                "description": "Whether the person's email is verified.",
                                "type": "boolean"
                              }
                            },
                            "type": "object"
                          },
                          "type": {
                            "const": "person",
                            "description": "The type of the user.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "object",
                          "name",
                          "avatar_url",
                          "type",
                          "person"
                        ],
                        "type": "object"
                      },
                      {
                        "$ref": "#/components/schemas/partialUserObjectResponse"
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "user"
                ],
                "title": "User",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "type": {
                    "const": "workspace",
                    "description": "Always `workspace`",
                    "type": "string"
                  },
                  "workspace": {
                    "const": true,
                    "description": "Details about the owner of the bot, when the `type` of the owner is `workspace`. This means the bot is for an internal integration.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "type",
                  "workspace"
                ],
                "title": "Workspace",
                "type": "object"
              }
            ]
          },
          "workspace_id": {
            "description": "The ID of the bot's workspace.",
            "type": "string"
          },
          "workspace_limits": {
            "additionalProperties": true,
            "description": "Limits and restrictions that apply to the bot's workspace",
            "properties": {
              "max_file_upload_size_in_bytes": {
                "description": "The maximum allowable size of a file upload, in bytes",
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "max_file_upload_size_in_bytes"
            ],
            "type": "object"
          },
          "workspace_name": {
            "description": "The name of the bot's workspace.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "owner",
          "workspace_id",
          "workspace_limits",
          "workspace_name"
        ],
        "type": "object"
      },
      "botUserObjectResponse": {
        "properties": {
          "bot": {
            "description": "Details about the bot, when the `type` of the user is `bot`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/CompatibleResponseemptyObject"
              },
              {
                "$ref": "#/components/schemas/botInfoResponse"
              }
            ]
          },
          "type": {
            "const": "bot",
            "description": "Indicates this user is a bot.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "bot"
        ],
        "title": "Bot",
        "type": "object"
      },
      "breadcrumbBlockObjectResponse": {
        "properties": {
          "breadcrumb": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "breadcrumb",
            "type": "string"
          }
        },
        "required": [
          "type",
          "breadcrumb",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Breadcrumb",
        "type": "object"
      },
      "bulletedListItemBlockObjectResponse": {
        "properties": {
          "bulleted_list_item": {
            "$ref": "#/components/schemas/contentWithRichTextAndColorResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "bulleted_list_item",
            "type": "string"
          }
        },
        "required": [
          "type",
          "bulleted_list_item",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Bulleted List Item",
        "type": "object"
      },
      "buttonDatabasePropertyConfigResponse": {
        "properties": {
          "button": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "button",
            "description": "Always `button`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "button"
        ],
        "title": "Button",
        "type": "object"
      },
      "buttonPropertyConfigurationRequest": {
        "properties": {
          "button": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "button",
            "description": "Always `button`",
            "type": "string"
          }
        },
        "required": [
          "button"
        ],
        "title": "Button",
        "type": "object"
      },
      "buttonPropertyItemObjectResponse": {
        "properties": {
          "button": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "button",
            "type": "string"
          }
        },
        "required": [
          "type",
          "button",
          "object",
          "id"
        ],
        "title": "Button",
        "type": "object"
      },
      "buttonSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "button": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "button",
            "description": "Always `button`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "button"
        ],
        "title": "Button",
        "type": "object"
      },
      "calendarViewConfigRequest": {
        "properties": {
          "date_property_id": {
            "description": "Property ID of the date property used to position items on the calendar.",
            "type": "string"
          },
          "properties": {
            "description": "Property visibility and display configuration on calendar cards. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_weekends": {
            "description": "Whether to show weekend days. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "calendar",
            "description": "The view type. Must be \"calendar\".",
            "type": "string"
          },
          "view_range": {
            "description": "Default calendar range. \"week\" shows a week view, \"month\" shows a month view. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `week`, `month`",
                "enum": [
                  "week",
                  "month"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "type",
          "date_property_id"
        ],
        "type": "object"
      },
      "calendarViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "date_property_id": {
            "description": "Date property used to position items on the calendar - required.",
            "type": "string"
          },
          "date_property_name": {
            "description": "Date property name (convenience field).",
            "type": "string"
          },
          "properties": {
            "description": "Properties to display on calendar event cards.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "show_weekends": {
            "description": "Whether to show weekend days.",
            "type": "boolean"
          },
          "type": {
            "const": "calendar",
            "description": "The view configuration type.",
            "type": "string"
          },
          "view_range": {
            "description": "Calendar view range.",
            "enum": [
              "week",
              "month"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "date_property_id"
        ],
        "type": "object"
      },
      "calloutBlockObjectResponse": {
        "properties": {
          "callout": {
            "properties": {
              "color": {
                "$ref": "#/components/schemas/CompatibleResponseapiColor"
              },
              "icon": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/pageIconResponse"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "rich_text": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "rich_text",
              "color",
              "icon"
            ],
            "type": "object"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "callout",
            "type": "string"
          }
        },
        "required": [
          "type",
          "callout",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Callout",
        "type": "object"
      },
      "chartAggregationRequest": {
        "properties": {
          "aggregator": {
            "description": "The aggregation operator. \"count\" counts all rows and does not require a property_id. All other operators require a property_id.",
            "enum": [
              "count",
              "count_values",
              "sum",
              "average",
              "median",
              "min",
              "max",
              "range",
              "unique",
              "empty",
              "not_empty",
              "percent_empty",
              "percent_not_empty",
              "checked",
              "unchecked",
              "percent_checked",
              "percent_unchecked",
              "earliest_date",
              "latest_date",
              "date_range"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "The property to aggregate on. Required for all operators except \"count\".",
            "type": "string"
          }
        },
        "required": [
          "aggregator"
        ],
        "type": "object"
      },
      "chartAggregationResponse": {
        "additionalProperties": true,
        "properties": {
          "aggregator": {
            "description": "The aggregation operator. \"count\" counts all rows and does not require a property_id. All other operators require a property_id.",
            "enum": [
              "count",
              "count_values",
              "sum",
              "average",
              "median",
              "min",
              "max",
              "range",
              "unique",
              "empty",
              "not_empty",
              "percent_empty",
              "percent_not_empty",
              "checked",
              "unchecked",
              "percent_checked",
              "percent_unchecked",
              "earliest_date",
              "latest_date",
              "date_range"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "The property to aggregate on. Required for all operators except \"count\".",
            "type": "string"
          }
        },
        "required": [
          "aggregator"
        ],
        "type": "object"
      },
      "chartReferenceLineRequest": {
        "properties": {
          "color": {
            "description": "Color of the reference line.",
            "enum": [
              "gray",
              "lightgray",
              "brown",
              "yellow",
              "orange",
              "green",
              "blue",
              "purple",
              "pink",
              "red"
            ],
            "type": "string"
          },
          "dash_style": {
            "description": "Line style: \"solid\" for a continuous line, \"dash\" for a dashed line.",
            "enum": [
              "solid",
              "dash"
            ],
            "type": "string"
          },
          "id": {
            "description": "Unique identifier for the reference line. Auto-generated if omitted.",
            "type": "string"
          },
          "label": {
            "description": "Label displayed alongside the reference line.",
            "type": "string"
          },
          "value": {
            "description": "The y-axis value where the reference line is drawn.",
            "type": "number"
          }
        },
        "required": [
          "value",
          "label",
          "color",
          "dash_style"
        ],
        "type": "object"
      },
      "chartReferenceLineResponse": {
        "additionalProperties": true,
        "properties": {
          "color": {
            "description": "Color of the reference line.",
            "enum": [
              "gray",
              "lightgray",
              "brown",
              "yellow",
              "orange",
              "green",
              "blue",
              "purple",
              "pink",
              "red"
            ],
            "type": "string"
          },
          "dash_style": {
            "description": "Line style: \"solid\" for a continuous line, \"dash\" for a dashed line.",
            "enum": [
              "solid",
              "dash"
            ],
            "type": "string"
          },
          "id": {
            "description": "Unique identifier for the reference line.",
            "type": "string"
          },
          "label": {
            "description": "Label displayed alongside the reference line.",
            "type": "string"
          },
          "value": {
            "description": "The y-axis value where the reference line is drawn.",
            "type": "number"
          }
        },
        "required": [
          "id",
          "value",
          "label",
          "color",
          "dash_style"
        ],
        "type": "object"
      },
      "chartViewConfigRequest": {
        "properties": {
          "axis_labels": {
            "description": "Which axis labels to show. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `none`, `x_axis`, `y_axis`, `both`",
                "enum": [
                  "none",
                  "x_axis",
                  "y_axis",
                  "both"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "caption": {
            "description": "Chart caption text. Pass null to clear.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "chart_type": {
            "description": "The chart type.",
            "enum": [
              "column",
              "bar",
              "line",
              "donut",
              "number"
            ],
            "type": "string"
          },
          "color_by_value": {
            "description": "Whether to color chart elements by their numeric value (gradient coloring). Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "color_theme": {
            "description": "Color theme. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `gray`, `blue`, `yellow`, `green`, `purple`, `teal`, `orange`, `pink`, `red`, `auto`, `colorful`",
                "enum": [
                  "gray",
                  "blue",
                  "yellow",
                  "green",
                  "purple",
                  "teal",
                  "orange",
                  "pink",
                  "red",
                  "auto",
                  "colorful"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cumulative": {
            "description": "Cumulative values (line only). Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "donut_labels": {
            "description": "Donut slice labels. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `none`, `value`, `name`, `name_and_value`",
                "enum": [
                  "none",
                  "value",
                  "name",
                  "name_and_value"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "grid_lines": {
            "description": "Which grid lines to show. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `none`, `horizontal`, `vertical`, `both`",
                "enum": [
                  "none",
                  "horizontal",
                  "vertical",
                  "both"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "group_style": {
            "description": "Grouped/stacked bar display style. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `normal`, `percent`, `side_by_side`",
                "enum": [
                  "normal",
                  "percent",
                  "side_by_side"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "height": {
            "description": "Chart height. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `small`, `medium`, `large`, `extra_large`",
                "enum": [
                  "small",
                  "medium",
                  "large",
                  "extra_large"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups with no data. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "hide_line_fill_area": {
            "description": "Hide area fill (line only). Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "hide_title": {
            "description": "Hide title (number only). Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "legend_position": {
            "description": "Legend position. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `off`, `bottom`, `side`",
                "enum": [
                  "off",
                  "bottom",
                  "side"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reference_lines": {
            "description": "Reference lines on the chart. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/chartReferenceLineRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_data_labels": {
            "description": "Whether to show data labels. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "smooth_line": {
            "description": "Smooth line curves (line only). Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "sort": {
            "description": "Sort order for chart data. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `manual`, `x_ascending`, `x_descending`, `y_ascending`, `y_descending`",
                "enum": [
                  "manual",
                  "x_ascending",
                  "x_descending",
                  "y_ascending",
                  "y_descending"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "stack_by": {
            "description": "Stack-by grouping for stacked/grouped bar charts. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "chart",
            "description": "The view type. Must be \"chart\".",
            "type": "string"
          },
          "value": {
            "description": "Aggregation for number charts. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/chartAggregationRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "x_axis": {
            "description": "X-axis grouping configuration for grouped data mode. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "x_axis_property_id": {
            "description": "Property ID for x-axis values in results mode. Pass null to clear.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis": {
            "description": "Y-axis aggregation for grouped data mode. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/chartAggregationRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_max": {
            "description": "Custom y-axis maximum. Pass null to clear.",
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_min": {
            "description": "Custom y-axis minimum. Pass null to clear.",
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_property_id": {
            "description": "Property ID for y-axis values in results mode. Pass null to clear.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "type",
          "chart_type"
        ],
        "type": "object"
      },
      "chartViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "axis_labels": {
            "description": "Which axis labels to display.",
            "enum": [
              "none",
              "x_axis",
              "y_axis",
              "both"
            ],
            "type": "string"
          },
          "caption": {
            "description": "Text caption displayed below the chart. Null when no caption is shown.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "chart_type": {
            "description": "The chart type: column (vertical bars), bar (horizontal bars), line, donut, or number (single value display).",
            "enum": [
              "column",
              "bar",
              "line",
              "donut",
              "number"
            ],
            "type": "string"
          },
          "color_by_value": {
            "description": "Whether chart elements are colored by their numeric value (gradient coloring).",
            "type": "boolean"
          },
          "color_theme": {
            "description": "Color theme for the chart.",
            "enum": [
              "gray",
              "blue",
              "yellow",
              "green",
              "purple",
              "teal",
              "orange",
              "pink",
              "red",
              "auto",
              "colorful"
            ],
            "type": "string"
          },
          "cumulative": {
            "description": "Whether to show cumulative values (line charts only).",
            "type": "boolean"
          },
          "donut_labels": {
            "description": "What to display on donut chart slices.",
            "enum": [
              "none",
              "value",
              "name",
              "name_and_value"
            ],
            "type": "string"
          },
          "grid_lines": {
            "description": "Which grid lines to display.",
            "enum": [
              "none",
              "horizontal",
              "vertical",
              "both"
            ],
            "type": "string"
          },
          "group_style": {
            "description": "How grouped/stacked bars are displayed. \"normal\" stacks values, \"percent\" normalizes to 100%, \"side_by_side\" places bars next to each other.",
            "enum": [
              "normal",
              "percent",
              "side_by_side"
            ],
            "type": "string"
          },
          "height": {
            "description": "Chart height.",
            "enum": [
              "small",
              "medium",
              "large",
              "extra_large"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups with no data on the x-axis.",
            "type": "boolean"
          },
          "hide_line_fill_area": {
            "description": "Whether to hide the shaded area under the line (line charts only).",
            "type": "boolean"
          },
          "hide_title": {
            "description": "Whether to hide the title label (number charts only).",
            "type": "boolean"
          },
          "legend_position": {
            "description": "Legend display position. \"off\" hides the legend.",
            "enum": [
              "off",
              "bottom",
              "side"
            ],
            "type": "string"
          },
          "reference_lines": {
            "description": "Reference lines drawn on the chart. Null when no reference lines are configured.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/chartReferenceLineResponse"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_data_labels": {
            "description": "Whether to show data value labels on chart elements.",
            "type": "boolean"
          },
          "smooth_line": {
            "description": "Whether to use smooth curves (line charts only).",
            "type": "boolean"
          },
          "sort": {
            "description": "Sort order for chart data.",
            "enum": [
              "manual",
              "x_ascending",
              "x_descending",
              "y_ascending",
              "y_descending"
            ],
            "type": "string"
          },
          "stack_by": {
            "description": "Stack-by grouping configuration for stacked/grouped bar charts (column/bar/line only). Null when not stacked.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "chart",
            "description": "The view configuration type.",
            "type": "string"
          },
          "value": {
            "$ref": "#/components/schemas/chartAggregationResponse",
            "description": "Aggregation configuration for number charts (single value display)."
          },
          "x_axis": {
            "description": "X-axis grouping configuration for column/bar/line/donut charts using grouped data. Null when using results (raw property values) mode.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "x_axis_property_id": {
            "description": "Property ID for the x-axis name values when using results (raw property values) mode.",
            "type": "string"
          },
          "y_axis": {
            "description": "Y-axis aggregation for column/bar/line/donut charts using grouped data. Null when using results mode.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/chartAggregationResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_max": {
            "description": "Custom maximum value for the y-axis. Null clears the override.",
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_min": {
            "description": "Custom minimum value for the y-axis. Null clears the override.",
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "y_axis_property_id": {
            "description": "Property ID for the y-axis numeric values when using results (raw property values) mode.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "chart_type"
        ],
        "type": "object"
      },
      "checkboxDatabasePropertyConfigResponse": {
        "properties": {
          "checkbox": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "checkbox",
            "description": "Always `checkbox`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "checkbox"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "checkboxGroupByConfigRequest": {
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "checkbox",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "checkboxGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (only manual for checkbox)."
          },
          "type": {
            "const": "checkbox",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "checkboxPropertyConfigurationRequest": {
        "properties": {
          "checkbox": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "checkbox",
            "description": "Always `checkbox`",
            "type": "string"
          }
        },
        "required": [
          "checkbox"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "checkboxPropertyFilter": {
        "anyOf": [
          {
            "properties": {
              "equals": {
                "type": "boolean"
              }
            },
            "required": [
              "equals"
            ],
            "type": "object"
          },
          {
            "properties": {
              "does_not_equal": {
                "type": "boolean"
              }
            },
            "required": [
              "does_not_equal"
            ],
            "type": "object"
          }
        ]
      },
      "checkboxPropertyItemObjectResponse": {
        "properties": {
          "checkbox": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "checkbox",
            "type": "string"
          }
        },
        "required": [
          "type",
          "checkbox",
          "object",
          "id"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "checkboxSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "checkbox": {
            "type": "boolean"
          },
          "type": {
            "const": "checkbox",
            "description": "Always `checkbox`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "checkbox"
        ],
        "title": "Checkbox",
        "type": "object"
      },
      "childDatabaseBlockObjectResponse": {
        "properties": {
          "child_database": {
            "$ref": "#/components/schemas/titleObjectResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "child_database",
            "type": "string"
          }
        },
        "required": [
          "type",
          "child_database",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Child Database",
        "type": "object"
      },
      "childPageBlockObjectResponse": {
        "properties": {
          "child_page": {
            "$ref": "#/components/schemas/titleObjectResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "child_page",
            "type": "string"
          }
        },
        "required": [
          "type",
          "child_page",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Child Page",
        "type": "object"
      },
      "codeBlockObjectResponse": {
        "properties": {
          "code": {
            "properties": {
              "caption": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemResponse"
                },
                "maxItems": 100,
                "type": "array"
              },
              "language": {
                "$ref": "#/components/schemas/CompatibleResponselanguageRequest"
              },
              "rich_text": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "rich_text",
              "caption",
              "language"
            ],
            "type": "object"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "code",
            "type": "string"
          }
        },
        "required": [
          "type",
          "code",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Code",
        "type": "object"
      },
      "columnBlockObjectResponse": {
        "properties": {
          "column": {
            "$ref": "#/components/schemas/columnResponse"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "column",
            "type": "string"
          }
        },
        "required": [
          "type",
          "column",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Column",
        "type": "object"
      },
      "columnBlockWithChildrenRequest": {
        "additionalProperties": false,
        "properties": {
          "column": {
            "$ref": "#/components/schemas/columnWithChildrenRequest"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "type": {
            "const": "column",
            "type": "string"
          }
        },
        "required": [
          "column"
        ],
        "title": "Column",
        "type": "object"
      },
      "columnListBlockObjectResponse": {
        "properties": {
          "column_list": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "column_list",
            "type": "string"
          }
        },
        "required": [
          "type",
          "column_list",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Column List",
        "type": "object"
      },
      "columnListRequest": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/columnBlockWithChildrenRequest"
            },
            "maxItems": 100,
            "minItems": 2,
            "type": "array"
          }
        },
        "required": [
          "children"
        ],
        "type": "object"
      },
      "columnResponse": {
        "properties": {
          "width_ratio": {
            "description": "Ratio between 0 and 1 of the width of this column relative to all columns in the list. If not provided, uses an equal width.",
            "examples": [
              0.5
            ],
            "type": "number"
          }
        },
        "type": "object"
      },
      "columnWithChildrenRequest": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/blockObjectWithSingleLevelOfChildrenRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "width_ratio": {
            "description": "Ratio between 0 and 1 of the width of this column relative to all columns in the list. If not provided, uses an equal width.",
            "examples": [
              0.5
            ],
            "exclusiveMaximum": 1,
            "exclusiveMinimum": 0,
            "type": "number"
          }
        },
        "required": [
          "children"
        ],
        "type": "object"
      },
      "commentCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "discussion_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the discussion containing the comment."
                  },
                  "page_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the page containing the comment."
                  },
                  "parent": {
                    "$ref": "#/components/schemas/webhookExternalBlock",
                    "description": "The parent of the comment (the page or block the comment is attached to)."
                  },
                  "property_id": {
                    "description": "The ID of the database property the comment is on, for comments on a page property. Matches the property's `id` in the page object. Omitted for other comments.",
                    "type": "string"
                  }
                },
                "required": [
                  "parent",
                  "page_id",
                  "discussion_id"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookCommentEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "comment.created",
                "description": "Always `comment.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "commentDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "discussion_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the discussion containing the comment."
                  },
                  "page_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the page containing the comment."
                  },
                  "parent": {
                    "$ref": "#/components/schemas/webhookExternalBlock",
                    "description": "The parent of the comment (the page or block the comment is attached to)."
                  },
                  "property_id": {
                    "description": "The ID of the database property the comment is on, for comments on a page property. Matches the property's `id` in the page object. Omitted for other comments.",
                    "type": "string"
                  }
                },
                "required": [
                  "parent",
                  "page_id",
                  "discussion_id"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookCommentEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "comment.deleted",
                "description": "Always `comment.deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "commentObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "attachments": {
            "description": "Any file attachments associated with the comment.",
            "items": {
              "additionalProperties": true,
              "properties": {
                "category": {
                  "description": "One of: `audio`, `image`, `pdf`, `productivity`, `video`",
                  "enum": [
                    "audio",
                    "image",
                    "pdf",
                    "productivity",
                    "video"
                  ],
                  "type": "string"
                },
                "file": {
                  "$ref": "#/components/schemas/internalFileResponse"
                }
              },
              "required": [
                "category",
                "file"
              ],
              "type": "object"
            },
            "maxItems": 100,
            "type": "array"
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse",
            "description": "The user who created the comment."
          },
          "created_time": {
            "description": "The time when the comment was created.",
            "format": "date-time",
            "type": "string"
          },
          "discussion_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the discussion thread this comment belongs to."
          },
          "display_name": {
            "additionalProperties": true,
            "description": "The display name of the comment.",
            "properties": {
              "resolved_name": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": {
                "description": "One of: `custom`, `user`, `integration`",
                "enum": [
                  "custom",
                  "user",
                  "integration"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "resolved_name"
            ],
            "type": "object"
          },
          "has_pending_attachments": {
            "description": "Whether any file attachments on this comment are still uploading. Pending files are not listed in `attachments` yet. A `comment.updated` webhook is sent when each upload finishes.",
            "type": "boolean"
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the comment."
          },
          "last_edited_time": {
            "description": "The time when the comment was last edited.",
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "comment",
            "description": "The comment object type name.",
            "type": "string"
          },
          "original_content_deleted": {
            "description": "Whether this comment's original content was deleted.",
            "type": "boolean"
          },
          "parent": {
            "$ref": "#/components/schemas/commentParentResponse",
            "description": "The parent of the comment."
          },
          "property_id": {
            "description": "The ID of the database property the comment is on, for comments on a page property. Matches the property's `id` in the page object. Omitted for other comments.",
            "type": "string"
          },
          "rich_text": {
            "description": "The rich text content of the comment.",
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "object",
          "id",
          "parent",
          "discussion_id",
          "created_time",
          "last_edited_time",
          "created_by",
          "rich_text",
          "display_name",
          "original_content_deleted",
          "has_pending_attachments"
        ],
        "type": "object"
      },
      "commentParentResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/pageIdCommentParentResponse"
          },
          {
            "$ref": "#/components/schemas/blockIdCommentParentResponse"
          }
        ]
      },
      "commentUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "discussion_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the discussion containing the comment."
                  },
                  "page_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The ID of the page containing the comment."
                  },
                  "parent": {
                    "$ref": "#/components/schemas/webhookExternalBlock",
                    "description": "The parent of the comment (the page or block the comment is attached to)."
                  },
                  "property_id": {
                    "description": "The ID of the database property the comment is on, for comments on a page property. Matches the property's `id` in the page object. Omitted for other comments.",
                    "type": "string"
                  }
                },
                "required": [
                  "parent",
                  "page_id",
                  "discussion_id"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookCommentEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "comment.updated",
                "description": "Always `comment.updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "contentPositionSchema": {
        "anyOf": [
          {
            "properties": {
              "after_block": {
                "properties": {
                  "id": {
                    "$ref": "#/components/schemas/idRequest"
                  }
                },
                "required": [
                  "id"
                ],
                "type": "object"
              },
              "type": {
                "const": "after_block",
                "type": "string"
              }
            },
            "required": [
              "type",
              "after_block"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "start",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "end",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        ]
      },
      "contentWithExpressionRequest": {
        "additionalProperties": false,
        "properties": {
          "expression": {
            "type": "string"
          }
        },
        "required": [
          "expression"
        ],
        "type": "object"
      },
      "contentWithRichTextAndColorAndListResponse": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseapiColor"
          },
          "list_format": {
            "$ref": "#/components/schemas/numberedListFormat"
          },
          "list_start_index": {
            "minimum": 1,
            "type": "integer"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text",
          "color"
        ],
        "type": "object"
      },
      "contentWithRichTextAndColorRequest": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "contentWithRichTextAndColorResponse": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseapiColor"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text",
          "color"
        ],
        "type": "object"
      },
      "contentWithRichTextColorAndIconRequest": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "icon": {
            "$ref": "#/components/schemas/pageIconRequest"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "contentWithRichTextColorAndIconResponse": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseapiColor"
          },
          "icon": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/pageIconResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text",
          "color",
          "icon"
        ],
        "type": "object"
      },
      "contentWithRichTextColorAndIconUpdateRequest": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "icon": {
            "$ref": "#/components/schemas/pageIconRequest"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "type": "object"
      },
      "contentWithRichTextRequest": {
        "additionalProperties": false,
        "properties": {
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "contentWithSingleLevelOfChildrenRequest": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
            },
            "maxItems": 100,
            "type": "array"
          },
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "contentWithTableResponse": {
        "properties": {
          "has_column_header": {
            "type": "boolean"
          },
          "has_row_header": {
            "type": "boolean"
          },
          "table_width": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "has_column_header",
          "has_row_header",
          "table_width"
        ],
        "type": "object"
      },
      "contentWithTableRowRequest": {
        "additionalProperties": false,
        "properties": {
          "cells": {
            "items": {
              "items": {
                "$ref": "#/components/schemas/richTextItemRequest"
              },
              "maxItems": 100,
              "type": "array"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "cells"
        ],
        "type": "object"
      },
      "contentWithTableRowResponse": {
        "properties": {
          "cells": {
            "items": {
              "items": {
                "$ref": "#/components/schemas/richTextItemResponse"
              },
              "maxItems": 100,
              "type": "array"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "cells"
        ],
        "type": "object"
      },
      "coverConfigRequest": {
        "properties": {
          "property_id": {
            "description": "Property ID when type is \"property\".",
            "type": "string"
          },
          "type": {
            "description": "Source of the cover image.",
            "enum": [
              "page_cover",
              "page_content",
              "property"
            ],
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "coverConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "property_id": {
            "description": "Property ID when type is \"property\".",
            "type": "string"
          },
          "type": {
            "description": "Source of the cover image.",
            "enum": [
              "page_cover",
              "page_content",
              "page_content_first",
              "property"
            ],
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "createDatabaseForViewRequest": {
        "properties": {
          "parent": {
            "description": "The parent page for the new linked database block.",
            "properties": {
              "page_id": {
                "$ref": "#/components/schemas/idRequest",
                "description": "The ID of the page to create the database on."
              },
              "type": {
                "const": "page_id",
                "description": "The parent type. Must be \"page_id\".",
                "type": "string"
              }
            },
            "required": [
              "type",
              "page_id"
            ],
            "type": "object"
          },
          "position": {
            "description": "Where to place the new database block within the parent page. Defaults to appending at the end.",
            "properties": {
              "block_id": {
                "$ref": "#/components/schemas/idRequest",
                "description": "The ID of an existing block in the page. The new database will be placed after this block."
              },
              "type": {
                "const": "after_block",
                "description": "Position type. \"after_block\" places the new database after the specified block in the page.",
                "type": "string"
              }
            },
            "required": [
              "type",
              "block_id"
            ],
            "type": "object"
          },
          "show_data_source_title": {
            "description": "Whether to show the data source title above the new linked database's views. Defaults to true.",
            "type": "boolean"
          }
        },
        "required": [
          "parent"
        ],
        "type": "object"
      },
      "createViewQueryRequest": {
        "properties": {
          "page_size": {
            "description": "The number of results to return per page. Maximum: 100",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "createViewRequest": {
        "properties": {
          "configuration": {
            "$ref": "#/components/schemas/viewConfigRequest",
            "description": "View presentation configuration. The type field must match the view type."
          },
          "create_database": {
            "$ref": "#/components/schemas/createDatabaseForViewRequest",
            "description": "Create a new linked database block on a page and add the view to it. Mutually exclusive with database_id and view_id."
          },
          "data_source_id": {
            "$ref": "#/components/schemas/idRequest",
            "description": "The ID of the data source this view should be scoped to."
          },
          "database_id": {
            "$ref": "#/components/schemas/idRequest",
            "description": "The ID of the database to create a view in. Mutually exclusive with view_id and create_database."
          },
          "filter": {
            "$ref": "#/components/schemas/viewFilterRequest",
            "description": "Filter to apply to the view. Uses the same format as the data source query filter. Simple property filters appear in the view's filter bar. For example, a status filter can exclude several values with does_not_equal."
          },
          "name": {
            "description": "The name of the view.",
            "type": "string"
          },
          "placement": {
            "$ref": "#/components/schemas/widgetPlacementRequest",
            "description": "Where to place the new widget in a dashboard view. Only applicable when view_id is provided. Defaults to creating a new row at the end."
          },
          "position": {
            "$ref": "#/components/schemas/viewPositionRequest",
            "description": "Where to place the new view in the database's view tab bar. Only applicable when database_id is provided. Defaults to \"end\" (append)."
          },
          "quick_filters": {
            "additionalProperties": {
              "$ref": "#/components/schemas/quickFilterConditionRequest"
            },
            "description": "Quick filters to pin in the view's filter bar. Keys are property names or IDs. Values are filter conditions (same shape as a property filter but without the property field). Each quick filter appears as a clickable pill above the view, independent of the advanced filter.",
            "type": "object"
          },
          "sorts": {
            "$ref": "#/components/schemas/viewSortsRequest",
            "description": "Property sorts to save on the view. Timestamp sorts are accepted but are not saved."
          },
          "type": {
            "$ref": "#/components/schemas/viewTypeRequest",
            "description": "The type of view to create."
          },
          "view_id": {
            "$ref": "#/components/schemas/idRequest",
            "description": "The ID of a dashboard view to add this view to as a widget. Mutually exclusive with database_id and create_database."
          }
        },
        "required": [
          "data_source_id",
          "name",
          "type"
        ],
        "type": "object"
      },
      "createdByDatabasePropertyConfigResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "created_by",
            "description": "Always `created_by`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_by"
        ],
        "title": "Created By",
        "type": "object"
      },
      "createdByPropertyConfigurationRequest": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "created_by",
            "description": "Always `created_by`",
            "type": "string"
          }
        },
        "required": [
          "created_by"
        ],
        "title": "Created By",
        "type": "object"
      },
      "createdByPropertyItemObjectResponse": {
        "properties": {
          "created_by": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/partialUserObjectResponse"
              },
              {
                "$ref": "#/components/schemas/userObjectResponse"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "created_by",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_by",
          "object",
          "id"
        ],
        "title": "Created By",
        "type": "object"
      },
      "createdBySimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/userValueResponse"
          },
          "type": {
            "const": "created_by",
            "description": "Always `created_by`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_by"
        ],
        "title": "Created By",
        "type": "object"
      },
      "createdTimeDatabasePropertyConfigResponse": {
        "properties": {
          "created_time": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "created_time",
            "description": "Always `created_time`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_time"
        ],
        "title": "Created Time",
        "type": "object"
      },
      "createdTimePropertyConfigurationRequest": {
        "properties": {
          "created_time": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "created_time",
            "description": "Always `created_time`",
            "type": "string"
          }
        },
        "required": [
          "created_time"
        ],
        "title": "Created Time",
        "type": "object"
      },
      "createdTimePropertyItemObjectResponse": {
        "properties": {
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "created_time",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_time",
          "object",
          "id"
        ],
        "title": "Created Time",
        "type": "object"
      },
      "createdTimeSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "type": {
            "const": "created_time",
            "description": "Always `created_time`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "created_time"
        ],
        "title": "Created Time",
        "type": "object"
      },
      "customEmojiPageIconRequest": {
        "properties": {
          "custom_emoji": {
            "properties": {
              "id": {
                "$ref": "#/components/schemas/idRequest",
                "description": "The ID of the custom emoji."
              },
              "name": {
                "description": "The name of the custom emoji.",
                "type": "string"
              },
              "url": {
                "description": "The URL of the custom emoji.",
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "type": {
            "const": "custom_emoji",
            "description": "Always `custom_emoji`",
            "type": "string"
          }
        },
        "required": [
          "custom_emoji"
        ],
        "title": "Custom Emoji",
        "type": "object"
      },
      "customEmojiPageIconResponse": {
        "additionalProperties": true,
        "properties": {
          "custom_emoji": {
            "$ref": "#/components/schemas/customEmojiResponse",
            "description": "The custom emoji details for the icon."
          },
          "type": {
            "const": "custom_emoji",
            "description": "Type of icon. In this case, a custom emoji.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "custom_emoji"
        ],
        "title": "Custom Emoji",
        "type": "object"
      },
      "customEmojiResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the custom emoji."
          },
          "name": {
            "description": "The name of the custom emoji.",
            "type": "string"
          },
          "url": {
            "description": "The URL of the custom emoji.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "url"
        ],
        "type": "object"
      },
      "dashboardRowResponse": {
        "additionalProperties": true,
        "properties": {
          "height": {
            "description": "Fixed height of the row in pixels.",
            "type": "integer"
          },
          "id": {
            "description": "The ID of this row module.",
            "type": "string"
          },
          "widgets": {
            "description": "The widget modules within this row.",
            "items": {
              "$ref": "#/components/schemas/dashboardWidgetResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "id",
          "widgets"
        ],
        "type": "object"
      },
      "dashboardViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "rows": {
            "description": "The rows that make up the dashboard layout. Each row contains one or more widget modules.",
            "items": {
              "$ref": "#/components/schemas/dashboardRowResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "dashboard",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rows"
        ],
        "type": "object"
      },
      "dashboardWidgetResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "description": "The ID of this widget module.",
            "type": "string"
          },
          "row_index": {
            "description": "The 0-based index of the row this widget belongs to. Widgets in the same row share the same row_index.",
            "type": "integer"
          },
          "view_id": {
            "description": "The ID of the collection view rendered by this widget.",
            "type": "string"
          },
          "width": {
            "description": "Width of the widget in a 12-column grid (1-12). 12 means full width.",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "view_id"
        ],
        "type": "object"
      },
      "dataSourceContentUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity whose content was updated."
                  },
                  "updated_blocks": {
                    "description": "The blocks that were updated in this event.",
                    "items": {
                      "$ref": "#/components/schemas/webhookUpdatedBlock"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "updated_blocks"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.content_updated",
                "description": "Always `data_source.content_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.created",
                "description": "Always `data_source.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.deleted",
                "description": "Always `data_source.deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceMovedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.moved",
                "description": "Always `data_source.moved`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "cover": {
            "description": "The cover of the data source.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageCoverResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse",
            "description": "The user who created the data source."
          },
          "created_time": {
            "description": "The time when the data source was created.",
            "format": "date-time",
            "type": "string"
          },
          "database_parent": {
            "$ref": "#/components/schemas/parentOfDatabaseResponse",
            "description": "The parent of the data source's containing database. This is typically a page, block, or workspace, but can be another database in the case of wikis."
          },
          "database_type": {
            "description": "The type of typed database this data source belongs to, or `null` for a regular data source.",
            "oneOf": [
              {
                "description": "One of: `tasks`, `projects`, `sprints`, `docs`, `wiki`, `meetings`, `meeting_notes`, `skills`, `github_prs`",
                "enum": [
                  "tasks",
                  "projects",
                  "sprints",
                  "docs",
                  "wiki",
                  "meetings",
                  "meeting_notes",
                  "skills",
                  "github_prs"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "description": "The description of the data source.",
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "icon": {
            "description": "The icon of the data source.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageIconResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the data source."
          },
          "in_trash": {
            "description": "Whether the data source is in the trash.",
            "type": "boolean"
          },
          "is_inline": {
            "description": "Whether the data source is inline.",
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse",
            "description": "The user who last edited the data source."
          },
          "last_edited_time": {
            "description": "The time when the data source was last edited.",
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "data_source",
            "description": "The data source object type name.",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentOfDataSourceResponse",
            "description": "The parent of the data source."
          },
          "properties": {
            "additionalProperties": {
              "$ref": "#/components/schemas/databasePropertyConfigResponse"
            },
            "description": "The properties schema of the data source.",
            "type": "object"
          },
          "public_url": {
            "description": "The public URL of the data source if it is publicly accessible.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "sync_metadata": {
            "additionalProperties": true,
            "description": "Sync identity and available health, included when listing or retrieving data sources.",
            "properties": {
              "external_collection_type": {
                "description": "The provider of a legacy synced data source: Jira or Salesforce. Values are case-sensitive.",
                "enum": [
                  "Jira",
                  "Salesforce"
                ],
                "type": "string"
              },
              "external_database_sync": {
                "additionalProperties": true,
                "description": "Stored identity of an external database sync.",
                "properties": {
                  "provider": {
                    "description": "The sync provider: github (GitHub), jira (Jira), or salesforce (Salesforce).",
                    "enum": [
                      "github",
                      "jira",
                      "salesforce"
                    ],
                    "type": "string"
                  },
                  "sync_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The stored sync ID. This is not a credential."
                  }
                },
                "required": [
                  "sync_id",
                  "provider"
                ],
                "type": "object"
              },
              "health": {
                "anyOf": [
                  {
                    "type": "null"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "checks": {
                        "additionalProperties": true,
                        "properties": {
                          "delta_synced_through_at": {
                            "type": "string"
                          },
                          "last_execution_succeeded_at": {
                            "type": "string"
                          },
                          "sync_version_updated_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "sync_version_updated_at"
                        ],
                        "type": "object"
                      },
                      "error": {
                        "additionalProperties": true,
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "severity": {
                            "enum": [
                              "action_required",
                              "degraded",
                              "failing"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "code",
                          "severity"
                        ],
                        "type": "object"
                      },
                      "ok": {
                        "const": false,
                        "type": "boolean"
                      },
                      "paused": {
                        "type": "boolean"
                      },
                      "stage": {
                        "enum": [
                          "backfilling",
                          "initializing",
                          "steady"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "checks",
                      "error",
                      "ok",
                      "paused",
                      "stage"
                    ],
                    "type": "object"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "checks": {
                        "additionalProperties": true,
                        "properties": {
                          "delta_synced_through_at": {
                            "type": "string"
                          },
                          "last_execution_succeeded_at": {
                            "type": "string"
                          },
                          "sync_version_updated_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "sync_version_updated_at"
                        ],
                        "type": "object"
                      },
                      "ok": {
                        "const": true,
                        "type": "boolean"
                      },
                      "paused": {
                        "type": "boolean"
                      },
                      "stage": {
                        "enum": [
                          "backfilling",
                          "initializing",
                          "steady"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "checks",
                      "ok",
                      "paused",
                      "stage"
                    ],
                    "type": "object"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "paused": {
                        "const": true,
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "paused"
                    ],
                    "type": "object"
                  }
                ],
                "description": "Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown."
              },
              "owner_user_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "Notion user who owns the sync credential, included when health is available."
              },
              "resource": {
                "description": "Provider resource synced to this data source, when available.",
                "type": "string"
              },
              "sync_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The stored sync ID when provider details are unavailable. This is not a credential."
              },
              "sync_state": {
                "additionalProperties": true,
                "description": "Stored state for a legacy synced data source. Missing or invalid timestamps are omitted. This is not a live health check.",
                "properties": {
                  "last_sync_checkpoint_at": {
                    "description": "Stored legacy sync checkpoint time in UTC ISO 8601 format.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "last_sync_heartbeat_at": {
                    "description": "Stored legacy sync heartbeat time in UTC ISO 8601 format.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "last_synced_at": {
                    "description": "Stored legacy sync update time in UTC ISO 8601 format. This does not guarantee that all source changes have been imported.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "syncing": {
                    "description": "Stored legacy sync state: true means syncing, false means not syncing, and row_limit_exceeded means the row limit stopped syncing. False does not guarantee a successful sync.",
                    "oneOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "const": "row_limit_exceeded",
                        "description": "Always `row_limit_exceeded`",
                        "type": "string"
                      }
                    ]
                  }
                },
                "required": [
                  "syncing"
                ],
                "type": "object"
              },
              "synced_collection_key": {
                "description": "Opaque, developer-defined collection key for a worker sync. It is not a globally unique ID or a credential. Worker status is not included.",
                "type": "string"
              }
            },
            "type": "object"
          },
          "title": {
            "description": "The title of the data source.",
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "url": {
            "description": "The URL of the data source.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "title",
          "description",
          "parent",
          "database_parent",
          "is_inline",
          "database_type",
          "in_trash",
          "created_time",
          "last_edited_time",
          "created_by",
          "last_edited_by",
          "properties",
          "icon",
          "cover",
          "url",
          "public_url"
        ],
        "type": "object"
      },
      "dataSourceParentResponse": {
        "additionalProperties": true,
        "properties": {
          "data_source_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent data source."
          },
          "database_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the data source's parent database."
          },
          "type": {
            "const": "data_source_id",
            "description": "The parent type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "data_source_id",
          "database_id"
        ],
        "type": "object"
      },
      "dataSourceReferenceResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the data source."
          },
          "name": {
            "description": "The name of the data source.",
            "type": "string"
          },
          "sync_metadata": {
            "additionalProperties": true,
            "description": "Sync identity and available health, included when retrieving a database.",
            "properties": {
              "external_collection_type": {
                "description": "The provider of a legacy synced data source: Jira or Salesforce. Values are case-sensitive.",
                "enum": [
                  "Jira",
                  "Salesforce"
                ],
                "type": "string"
              },
              "external_database_sync": {
                "additionalProperties": true,
                "description": "Stored identity of an external database sync.",
                "properties": {
                  "provider": {
                    "description": "The sync provider: github (GitHub), jira (Jira), or salesforce (Salesforce).",
                    "enum": [
                      "github",
                      "jira",
                      "salesforce"
                    ],
                    "type": "string"
                  },
                  "sync_id": {
                    "$ref": "#/components/schemas/idResponse",
                    "description": "The stored sync ID. This is not a credential."
                  }
                },
                "required": [
                  "sync_id",
                  "provider"
                ],
                "type": "object"
              },
              "health": {
                "anyOf": [
                  {
                    "type": "null"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "checks": {
                        "additionalProperties": true,
                        "properties": {
                          "delta_synced_through_at": {
                            "type": "string"
                          },
                          "last_execution_succeeded_at": {
                            "type": "string"
                          },
                          "sync_version_updated_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "sync_version_updated_at"
                        ],
                        "type": "object"
                      },
                      "error": {
                        "additionalProperties": true,
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "severity": {
                            "enum": [
                              "action_required",
                              "degraded",
                              "failing"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "code",
                          "severity"
                        ],
                        "type": "object"
                      },
                      "ok": {
                        "const": false,
                        "type": "boolean"
                      },
                      "paused": {
                        "type": "boolean"
                      },
                      "stage": {
                        "enum": [
                          "backfilling",
                          "initializing",
                          "steady"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "checks",
                      "error",
                      "ok",
                      "paused",
                      "stage"
                    ],
                    "type": "object"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "checks": {
                        "additionalProperties": true,
                        "properties": {
                          "delta_synced_through_at": {
                            "type": "string"
                          },
                          "last_execution_succeeded_at": {
                            "type": "string"
                          },
                          "sync_version_updated_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "sync_version_updated_at"
                        ],
                        "type": "object"
                      },
                      "ok": {
                        "const": true,
                        "type": "boolean"
                      },
                      "paused": {
                        "type": "boolean"
                      },
                      "stage": {
                        "enum": [
                          "backfilling",
                          "initializing",
                          "steady"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "checks",
                      "ok",
                      "paused",
                      "stage"
                    ],
                    "type": "object"
                  },
                  {
                    "additionalProperties": true,
                    "properties": {
                      "paused": {
                        "const": true,
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "paused"
                    ],
                    "type": "object"
                  }
                ],
                "description": "Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown."
              },
              "owner_user_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "Notion user who owns the sync credential, included when health is available."
              },
              "resource": {
                "description": "Provider resource synced to this data source, when available.",
                "type": "string"
              },
              "sync_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The stored sync ID when provider details are unavailable. This is not a credential."
              },
              "sync_state": {
                "additionalProperties": true,
                "description": "Stored state for a legacy synced data source. Missing or invalid timestamps are omitted. This is not a live health check.",
                "properties": {
                  "last_sync_checkpoint_at": {
                    "description": "Stored legacy sync checkpoint time in UTC ISO 8601 format.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "last_sync_heartbeat_at": {
                    "description": "Stored legacy sync heartbeat time in UTC ISO 8601 format.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "last_synced_at": {
                    "description": "Stored legacy sync update time in UTC ISO 8601 format. This does not guarantee that all source changes have been imported.",
                    "format": "date-time",
                    "type": "string"
                  },
                  "syncing": {
                    "description": "Stored legacy sync state: true means syncing, false means not syncing, and row_limit_exceeded means the row limit stopped syncing. False does not guarantee a successful sync.",
                    "oneOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "const": "row_limit_exceeded",
                        "description": "Always `row_limit_exceeded`",
                        "type": "string"
                      }
                    ]
                  }
                },
                "required": [
                  "syncing"
                ],
                "type": "object"
              },
              "synced_collection_key": {
                "description": "Opaque, developer-defined collection key for a worker sync. It is not a globally unique ID or a credential. Worker status is not included.",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "dataSourceSchemaUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the database whose schema was updated."
                  },
                  "updated_properties": {
                    "description": "The database properties that were created, updated, or deleted.",
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "action": {
                          "description": "The action taken on the property.",
                          "enum": [
                            "created",
                            "updated",
                            "deleted"
                          ],
                          "type": "string"
                        },
                        "id": {
                          "description": "The ID of the database property that changed.",
                          "type": "string"
                        },
                        "name": {
                          "description": "The name of the database property, or `null` if deleted.",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "action"
                      ],
                      "type": "object"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.schema_updated",
                "description": "Always `data_source.schema_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceUndeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "data_source.undeleted",
                "description": "Always `data_source.undeleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dataSourceViewObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "description": "View presentation configuration.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/viewConfigResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_by": {
            "description": "The user who created the view, or null if not available.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/partialUserObjectResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_time": {
            "description": "The time when the view was created.",
            "format": "date-time",
            "type": "string"
          },
          "dashboard_view_id": {
            "description": "For dashboard widget views, the ID of the parent dashboard view. Only present when this view is a widget inside a dashboard.",
            "type": "string"
          },
          "data_source_id": {
            "description": "The ID of the data source this view is scoped to, or null for dashboard views.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "filter": {
            "description": "The filter applied to this view (same shape as data source query filter).",
            "oneOf": [
              {
                "$ref": "#/components/schemas/viewFilterResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the view."
          },
          "last_edited_by": {
            "description": "The user who last edited the view, or null if not available.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/partialUserObjectResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_edited_time": {
            "description": "The time when the view was last edited.",
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "description": "The name of the view.",
            "type": "string"
          },
          "object": {
            "const": "view",
            "description": "The object type name.",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/databaseParentResponse",
            "description": "The parent database of the view."
          },
          "quick_filters": {
            "description": "Quick filters pinned to the view's filter bar. Keys are property IDs. Values are filter conditions (same shape as a property filter without the property field). Null when no quick filters are set.",
            "oneOf": [
              {
                "additionalProperties": {
                  "$ref": "#/components/schemas/quickFilterConditionResponse"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "sorts": {
            "description": "The sorts applied to this view (same shape as data source query sorts).",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewSortResponse"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "description": "The view type.",
            "enum": [
              "table",
              "board",
              "list",
              "calendar",
              "timeline",
              "gallery",
              "form",
              "chart",
              "map",
              "dashboard"
            ],
            "type": "string"
          },
          "url": {
            "description": "Canonical deep link to the view in Notion.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "parent",
          "name",
          "type",
          "created_time",
          "last_edited_time",
          "url"
        ],
        "type": "object"
      },
      "dataSourceViewReferenceResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the view."
          },
          "object": {
            "const": "view",
            "description": "The object type name.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "databaseContentUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity whose content was updated."
                  },
                  "updated_blocks": {
                    "description": "The blocks that were updated in this event.",
                    "items": {
                      "$ref": "#/components/schemas/webhookUpdatedBlock"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "updated_blocks"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.content_updated",
                "description": "Always `database.content_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "databaseCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.created",
                "description": "Always `database.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "databaseDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.deleted",
                "description": "Always `database.deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "databaseMovedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.moved",
                "description": "Always `database.moved`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "databaseObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "cover": {
            "description": "The cover of the database.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageCoverResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_time": {
            "description": "The time when the database was created.",
            "format": "date-time",
            "type": "string"
          },
          "data_sources": {
            "description": "The data sources of the database.",
            "items": {
              "$ref": "#/components/schemas/dataSourceReferenceResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "database_type": {
            "description": "The type of typed database, such as `tasks`, `projects`, or `skills`, or `null` for a regular database. Create a database accepts `tasks`, `projects`, and `skills`.",
            "oneOf": [
              {
                "description": "One of: `tasks`, `projects`, `sprints`, `docs`, `wiki`, `meetings`, `meeting_notes`, `skills`, `github_prs`",
                "enum": [
                  "tasks",
                  "projects",
                  "sprints",
                  "docs",
                  "wiki",
                  "meetings",
                  "meeting_notes",
                  "skills",
                  "github_prs"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "description": "The description of the database.",
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "icon": {
            "description": "The icon of the database.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageIconResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the database."
          },
          "in_trash": {
            "description": "Whether the database is in the trash.",
            "type": "boolean"
          },
          "is_inline": {
            "description": "Whether the database is inline.",
            "type": "boolean"
          },
          "is_locked": {
            "description": "Whether the database is locked from editing in the Notion app UI.",
            "type": "boolean"
          },
          "last_edited_time": {
            "description": "The time when the database was last edited.",
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "database",
            "description": "The database object type name.",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentOfDatabaseResponse",
            "description": "The parent of the database. This is typically a page, block, or workspace, but can be another database in the case of wikis."
          },
          "public_url": {
            "description": "The public URL of the database if it is publicly accessible.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_data_source_title": {
            "description": "Whether the data source title is shown above the database's views, matching the Show data source title toggle in the Notion app. Full-page databases with one data source don't show this title even when this is `true`.",
            "type": "boolean"
          },
          "title": {
            "description": "The title of the database.",
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "url": {
            "description": "The URL of the database.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "title",
          "description",
          "parent",
          "is_inline",
          "database_type",
          "in_trash",
          "is_locked",
          "show_data_source_title",
          "created_time",
          "last_edited_time",
          "data_sources",
          "icon",
          "cover",
          "url",
          "public_url"
        ],
        "type": "object"
      },
      "databaseParentResponse": {
        "additionalProperties": true,
        "properties": {
          "database_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent database."
          },
          "type": {
            "const": "database_id",
            "description": "The parent type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "database_id"
        ],
        "type": "object"
      },
      "databasePropertyConfigResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/databasePropertyConfigResponseCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/numberDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/formulaDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/selectDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/multiSelectDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/statusDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/relationDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/rollupDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/uniqueIdDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/titleDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/richTextDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/urlDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/peopleDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/filesDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/emailDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/phoneNumberDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/dateDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/checkboxDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/createdByDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/createdTimeDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/lastEditedByDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/lastEditedTimeDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/buttonDatabasePropertyConfigResponse"
              },
              {
                "$ref": "#/components/schemas/placeDatabasePropertyConfigResponse"
              }
            ]
          }
        ]
      },
      "databasePropertyConfigResponseCommon": {
        "additionalProperties": true,
        "properties": {
          "description": {
            "description": "The description of the property.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/CompatibleResponsepropertyDescriptionRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "description": "The ID of the property.",
            "type": "string"
          },
          "name": {
            "description": "The name of the property.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "description"
        ],
        "type": "object"
      },
      "databasePropertyRelationConfigResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/databasePropertyRelationConfigResponseCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/singlePropertyDatabasePropertyRelationConfigResponse"
              },
              {
                "$ref": "#/components/schemas/dualPropertyDatabasePropertyRelationConfigResponse"
              }
            ]
          }
        ]
      },
      "databasePropertyRelationConfigResponseCommon": {
        "additionalProperties": true,
        "properties": {
          "data_source_id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "database_id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "limit": {
            "description": "The maximum number of pages each page can relate to, or null when there is no limit. Read-only.",
            "oneOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "database_id",
          "data_source_id",
          "limit"
        ],
        "type": "object"
      },
      "databaseSchemaUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the database whose schema was updated."
                  },
                  "updated_properties": {
                    "description": "The database properties that were created, updated, or deleted.",
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "action": {
                          "description": "The action taken on the property.",
                          "enum": [
                            "created",
                            "updated",
                            "deleted"
                          ],
                          "type": "string"
                        },
                        "id": {
                          "description": "The ID of the database property that changed.",
                          "type": "string"
                        },
                        "name": {
                          "description": "The name of the database property, or `null` if deleted.",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "action"
                      ],
                      "type": "object"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.schema_updated",
                "description": "Always `database.schema_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "databaseUndeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookDatabaseEventEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "database.undeleted",
                "description": "Always `database.undeleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "dateDatabasePropertyConfigResponse": {
        "properties": {
          "date": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "date",
            "description": "Always `date`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "dateFormulaPropertyResponse": {
        "properties": {
          "date": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "date",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "dateFormulaPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "date": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "date",
            "description": "Always `date`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "dateGroupByConfigRequest": {
        "properties": {
          "group_by": {
            "description": "Granularity for date grouping.",
            "enum": [
              "relative",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "start_day_of_week": {
            "description": "Start day of week for week grouping (0 = Sunday, 1 = Monday).",
            "enum": [
              0,
              1
            ],
            "type": "number"
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "date",
              "created_time",
              "last_edited_time"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "dateGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "description": "Granularity for date grouping.",
            "enum": [
              "relative",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (no manual sort for dates)."
          },
          "start_day_of_week": {
            "description": "Start day of week for week grouping (0 = Sunday, 1 = Monday).",
            "enum": [
              0,
              1
            ],
            "type": "number"
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "date",
              "created_time",
              "last_edited_time"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "dateOrRelativeDate": {
        "anyOf": [
          {
            "format": "date",
            "type": "string"
          },
          {
            "$ref": "#/components/schemas/relativeDateValue"
          }
        ]
      },
      "datePartialRollupValueResponse": {
        "properties": {
          "date": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "date",
            "description": "Always `date`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "datePropertyConfigurationRequest": {
        "properties": {
          "date": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "date",
            "description": "Always `date`",
            "type": "string"
          }
        },
        "required": [
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "datePropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "equals": {
                    "$ref": "#/components/schemas/dateOrRelativeDate"
                  }
                },
                "required": [
                  "equals"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "before": {
                    "$ref": "#/components/schemas/dateOrRelativeDate"
                  }
                },
                "required": [
                  "before"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "after": {
                    "$ref": "#/components/schemas/dateOrRelativeDate"
                  }
                },
                "required": [
                  "after"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "on_or_before": {
                    "$ref": "#/components/schemas/dateOrRelativeDate"
                  }
                },
                "required": [
                  "on_or_before"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "on_or_after": {
                    "$ref": "#/components/schemas/dateOrRelativeDate"
                  }
                },
                "required": [
                  "on_or_after"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "this_week": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "this_week"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "past_week": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "past_week"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "past_month": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "past_month"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "past_year": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "past_year"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "next_week": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "next_week"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "next_month": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "next_month"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "next_year": {
                    "$ref": "#/components/schemas/emptyObject"
                  }
                },
                "required": [
                  "next_year"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "datePropertyItemObjectResponse": {
        "properties": {
          "date": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "date",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date",
          "object",
          "id"
        ],
        "title": "Date",
        "type": "object"
      },
      "dateRequest": {
        "additionalProperties": false,
        "properties": {
          "end": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])[Tt](?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "type": "string"
              },
              {
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The end date of the date object, if any."
          },
          "start": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])[Tt](?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "type": "string"
              },
              {
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$",
                "type": "string"
              }
            ],
            "description": "The start date of the date object."
          },
          "time_zone": {
            "description": "The time zone of the date object, if any. E.g. America/Los_Angeles, Europe/London, etc.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/timeZoneRequest"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "start"
        ],
        "type": "object"
      },
      "dateResponse": {
        "additionalProperties": true,
        "properties": {
          "end": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])[Tt](?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "type": "string"
              },
              {
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The end date of the date object, if any."
          },
          "start": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "format": "date-time",
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])[Tt](?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "type": "string"
              },
              {
                "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$",
                "type": "string"
              }
            ],
            "description": "The start date of the date object."
          },
          "time_zone": {
            "description": "The time zone of the date object.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/CompatibleResponsetimeZoneRequest"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "start",
          "end",
          "time_zone"
        ],
        "type": "object"
      },
      "dateSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "date": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "date",
            "description": "Always `date`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date"
        ],
        "title": "Date",
        "type": "object"
      },
      "deletedViewQueryResponse": {
        "additionalProperties": true,
        "properties": {
          "deleted": {
            "description": "Whether the view query was deleted.",
            "type": "boolean"
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the deleted view query."
          },
          "object": {
            "const": "view_query",
            "description": "The object type.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "deleted"
        ],
        "type": "object"
      },
      "dividerBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "divider": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "divider",
            "type": "string"
          }
        },
        "required": [
          "type",
          "divider",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Divider",
        "type": "object"
      },
      "dualPropertyDatabasePropertyRelationConfigResponse": {
        "properties": {
          "dual_property": {
            "additionalProperties": true,
            "properties": {
              "synced_property_id": {
                "type": "string"
              },
              "synced_property_name": {
                "type": "string"
              }
            },
            "required": [
              "synced_property_id",
              "synced_property_name"
            ],
            "type": "object"
          },
          "type": {
            "const": "dual_property",
            "description": "Always `dual_property`",
            "type": "string"
          }
        },
        "required": [
          "dual_property"
        ],
        "title": "Dual Property",
        "type": "object"
      },
      "emailDatabasePropertyConfigResponse": {
        "properties": {
          "email": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "email",
            "description": "Always `email`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "email"
        ],
        "title": "Email",
        "type": "object"
      },
      "emailPropertyConfigurationRequest": {
        "properties": {
          "email": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "email",
            "description": "Always `email`",
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "title": "Email",
        "type": "object"
      },
      "emailPropertyItemObjectResponse": {
        "properties": {
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "email",
            "type": "string"
          }
        },
        "required": [
          "type",
          "email",
          "object",
          "id"
        ],
        "title": "Email",
        "type": "object"
      },
      "emailSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "email": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "email",
            "description": "Always `email`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "email"
        ],
        "title": "Email",
        "type": "object"
      },
      "embedBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "embed": {
            "$ref": "#/components/schemas/mediaContentWithUrlAndCaptionResponse"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "embed",
            "type": "string"
          }
        },
        "required": [
          "type",
          "embed",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Embed",
        "type": "object"
      },
      "embedFileUploadRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "file_upload": {
            "$ref": "#/components/schemas/fileUploadIdRequest"
          },
          "type": {
            "const": "file_upload",
            "type": "string"
          }
        },
        "required": [
          "file_upload"
        ],
        "type": "object"
      },
      "emojiPageIconRequest": {
        "properties": {
          "emoji": {
            "$ref": "#/components/schemas/emojiRequest",
            "description": "An emoji character."
          },
          "type": {
            "const": "emoji",
            "description": "Always `emoji`",
            "type": "string"
          }
        },
        "required": [
          "emoji"
        ],
        "title": "Emoji",
        "type": "object"
      },
      "emojiPageIconResponse": {
        "additionalProperties": true,
        "properties": {
          "emoji": {
            "$ref": "#/components/schemas/CompatibleResponseemojiRequest",
            "description": "The emoji character used as the icon."
          },
          "type": {
            "const": "emoji",
            "description": "Type of icon. In this case, an emoji.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "emoji"
        ],
        "title": "Emoji",
        "type": "object"
      },
      "emojiRequest": {
        "example": "😀",
        "type": "string"
      },
      "emptyObject": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "equationBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "equation": {
            "$ref": "#/components/schemas/expressionObjectResponse"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "equation",
            "type": "string"
          }
        },
        "required": [
          "type",
          "equation",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Equation",
        "type": "object"
      },
      "equationRichTextItemRequest": {
        "properties": {
          "equation": {
            "description": "Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.",
            "properties": {
              "expression": {
                "description": "A KaTeX compatible string.",
                "examples": [
                  "e=mc^2"
                ],
                "type": "string"
              }
            },
            "required": [
              "expression"
            ],
            "type": "object"
          },
          "type": {
            "const": "equation",
            "description": "Always `equation`",
            "type": "string"
          }
        },
        "required": [
          "equation"
        ],
        "title": "Equation",
        "type": "object"
      },
      "equationRichTextItemResponse": {
        "properties": {
          "equation": {
            "additionalProperties": true,
            "description": "Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.",
            "properties": {
              "expression": {
                "description": "A KaTeX compatible string.",
                "examples": [
                  "e=mc^2"
                ],
                "type": "string"
              }
            },
            "required": [
              "expression"
            ],
            "type": "object"
          },
          "type": {
            "const": "equation",
            "description": "Always `equation`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "equation"
        ],
        "title": "Equation",
        "type": "object"
      },
      "error_api_400": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "invalid_json",
                  "invalid_request_url",
                  "invalid_request",
                  "missing_version",
                  "invalid_beta",
                  "validation_error",
                  "invalid_credit_limit"
                ]
              },
              "status": {
                "const": 400
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_401": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "unauthorized"
                ]
              },
              "status": {
                "const": 401
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_403": {
        "oneOf": [
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/publicApiCommonErrorResponse"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "code": {
                    "enum": [
                      "restricted_resource",
                      "status_change_not_allowed"
                    ]
                  },
                  "status": {
                    "const": 403
                  }
                },
                "required": [
                  "code",
                  "status"
                ],
                "type": "object"
              }
            ]
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/publicApiCommonErrorResponse"
              },
              {
                "properties": {
                  "additional_data": {
                    "additionalProperties": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        }
                      ]
                    },
                    "properties": {
                      "recovery_kind": {
                        "description": "The recovery action selected by Notion for the caller.",
                        "enum": [
                          "contact_workspace_owner",
                          "open_workspace_credit_settings"
                        ]
                      },
                      "recovery_url": {
                        "description": "Present when recovery_kind directs the caller to a settings page.",
                        "format": "uri",
                        "type": "string"
                      },
                      "tool_error_class": {
                        "const": "entitlement_required"
                      },
                      "tool_error_code": {
                        "const": "workspace_credits_exhausted"
                      },
                      "tool_error_retryable": {
                        "const": "false"
                      }
                    },
                    "required": [
                      "tool_error_code",
                      "tool_error_class",
                      "tool_error_retryable",
                      "recovery_kind"
                    ],
                    "type": "object"
                  },
                  "code": {
                    "const": "workspace_credits_exhausted"
                  },
                  "status": {
                    "const": 403
                  }
                },
                "required": [
                  "code",
                  "status",
                  "additional_data"
                ],
                "type": "object"
              }
            ]
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/publicApiCommonErrorResponse"
              },
              {
                "properties": {
                  "additional_data": {
                    "additionalProperties": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        }
                      ]
                    },
                    "properties": {
                      "recovery_kind": {
                        "description": "The recovery action selected by Notion for the caller.",
                        "enum": [
                          "contact_workspace_owner",
                          "none",
                          "open_agent_settings",
                          "request_agent_limit_increase",
                          "request_pending"
                        ]
                      },
                      "recovery_url": {
                        "description": "Present when recovery_kind directs the caller to a settings page.",
                        "format": "uri",
                        "type": "string"
                      },
                      "tool_error_class": {
                        "const": "entitlement_required"
                      },
                      "tool_error_code": {
                        "const": "agent_credit_limit_reached"
                      },
                      "tool_error_retryable": {
                        "const": "false"
                      }
                    },
                    "required": [
                      "tool_error_code",
                      "tool_error_class",
                      "tool_error_retryable",
                      "recovery_kind"
                    ],
                    "type": "object"
                  },
                  "code": {
                    "const": "agent_credit_limit_reached"
                  },
                  "status": {
                    "const": 403
                  }
                },
                "required": [
                  "code",
                  "status",
                  "additional_data"
                ],
                "type": "object"
              }
            ]
          }
        ]
      },
      "error_api_404": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "object_not_found",
                  "directory_not_found"
                ]
              },
              "status": {
                "const": 404
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_406": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "row_limit_exceeded"
                ]
              },
              "status": {
                "const": 406
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_409": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "conflict_error",
                  "idempotency_key_reused",
                  "agent_deleted"
                ]
              },
              "status": {
                "const": 409
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_429": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "rate_limited"
                ]
              },
              "status": {
                "const": 429
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_500": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "internal_server_error"
                ]
              },
              "status": {
                "const": 500
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_503": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "service_unavailable"
                ]
              },
              "status": {
                "const": 503
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_504": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "gateway_timeout"
                ]
              },
              "status": {
                "const": 504
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_api_529": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "service_overload"
                ]
              },
              "status": {
                "const": 529
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_oauth_400": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "invalid_request",
                  "invalid_grant",
                  "unauthorized_client",
                  "unsupported_grant_type",
                  "invalid_scope"
                ]
              },
              "status": {
                "const": 400
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_oauth_401": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "invalid_client"
                ]
              },
              "status": {
                "const": 401
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_oauth_403": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "test_env_error"
                ]
              },
              "status": {
                "const": 403
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "error_oauth_500": {
        "allOf": [
          {
            "$ref": "#/components/schemas/publicApiCommonErrorResponse"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "enum": [
                  "internal_server_error"
                ]
              },
              "status": {
                "const": 500
              }
            },
            "required": [
              "code",
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "existencePropertyFilter": {
        "anyOf": [
          {
            "properties": {
              "is_empty": {
                "const": true,
                "type": "boolean"
              }
            },
            "required": [
              "is_empty"
            ],
            "type": "object"
          },
          {
            "properties": {
              "is_not_empty": {
                "const": true,
                "type": "boolean"
              }
            },
            "required": [
              "is_not_empty"
            ],
            "type": "object"
          }
        ]
      },
      "expressionObjectResponse": {
        "properties": {
          "expression": {
            "type": "string"
          }
        },
        "required": [
          "expression"
        ],
        "type": "object"
      },
      "externalFileRequest": {
        "additionalProperties": false,
        "properties": {
          "url": {
            "$ref": "#/components/schemas/textRequest"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "externalInternalOrExternalFileWithNameResponse": {
        "properties": {
          "external": {
            "additionalProperties": true,
            "description": "The external URL.",
            "properties": {
              "url": {
                "description": "The URL of the external file or resource.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "description": "Type of attachment. In this case, an external URL.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "external"
        ],
        "title": "External",
        "type": "object"
      },
      "externalMediaContentWithFileAndCaptionResponse": {
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "external": {
            "properties": {
              "url": {
                "$ref": "#/components/schemas/CompatibleResponsetextRequest"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "type": "string"
          }
        },
        "required": [
          "type",
          "external",
          "caption"
        ],
        "title": "External",
        "type": "object"
      },
      "externalMediaContentWithFileNameAndCaptionResponse": {
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "external": {
            "properties": {
              "url": {
                "$ref": "#/components/schemas/CompatibleResponsetextRequest"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "const": "external",
            "type": "string"
          }
        },
        "required": [
          "type",
          "external",
          "caption",
          "name"
        ],
        "title": "External",
        "type": "object"
      },
      "externalPageCoverRequest": {
        "properties": {
          "external": {
            "description": "External URL for the cover.",
            "properties": {
              "url": {
                "description": "The URL of the external file.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "description": "Always `external`",
            "type": "string"
          }
        },
        "required": [
          "external"
        ],
        "title": "External",
        "type": "object"
      },
      "externalPageCoverResponse": {
        "additionalProperties": true,
        "properties": {
          "external": {
            "additionalProperties": true,
            "description": "The external URL for the cover.",
            "properties": {
              "url": {
                "description": "The URL of the external file or resource.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "description": "Type of cover. In this case, an external URL.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "external"
        ],
        "title": "External",
        "type": "object"
      },
      "externalPageIconRequest": {
        "properties": {
          "external": {
            "properties": {
              "url": {
                "description": "The URL of the external file.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "description": "Always `external`",
            "type": "string"
          }
        },
        "required": [
          "external"
        ],
        "title": "External",
        "type": "object"
      },
      "externalPageIconResponse": {
        "additionalProperties": true,
        "properties": {
          "external": {
            "additionalProperties": true,
            "description": "The external URL for the icon.",
            "properties": {
              "url": {
                "description": "The URL of the external file or resource.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "type": {
            "const": "external",
            "description": "Type of icon. In this case, an external URL.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "external"
        ],
        "title": "External",
        "type": "object"
      },
      "fileBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "file": {
            "$ref": "#/components/schemas/mediaContentWithFileNameAndCaptionResponse"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "file",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "File",
        "type": "object"
      },
      "fileInternalOrExternalFileWithNameResponse": {
        "properties": {
          "file": {
            "$ref": "#/components/schemas/internalFileResponse",
            "description": "The file URL."
          },
          "type": {
            "const": "file",
            "description": "Type of attachment. In this case, a file uploaded to a Notion workspace.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file"
        ],
        "title": "File",
        "type": "object"
      },
      "fileMediaContentWithFileAndCaptionResponse": {
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "file": {
            "$ref": "#/components/schemas/internalFileResponse"
          },
          "type": {
            "const": "file",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file",
          "caption"
        ],
        "title": "File",
        "type": "object"
      },
      "fileMediaContentWithFileNameAndCaptionResponse": {
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "file": {
            "$ref": "#/components/schemas/internalFileResponse"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "const": "file",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file",
          "caption",
          "name"
        ],
        "title": "File",
        "type": "object"
      },
      "filePageCoverResponse": {
        "additionalProperties": true,
        "properties": {
          "file": {
            "$ref": "#/components/schemas/internalFileResponse",
            "description": "The file URL for the cover."
          },
          "type": {
            "const": "file",
            "description": "Type of cover. In this case, a file.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file"
        ],
        "title": "File",
        "type": "object"
      },
      "filePageIconResponse": {
        "additionalProperties": true,
        "properties": {
          "file": {
            "$ref": "#/components/schemas/internalFileResponse",
            "description": "The file URL for the icon."
          },
          "type": {
            "const": "file",
            "description": "Type of icon. In this case, a file.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "file"
        ],
        "title": "File",
        "type": "object"
      },
      "fileUploadCompletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "entity": {
                "$ref": "#/components/schemas/webhookFileUploadEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "file_upload.completed",
                "description": "Always `file_upload.completed`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity"
            ],
            "type": "object"
          }
        ]
      },
      "fileUploadCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "entity": {
                "$ref": "#/components/schemas/webhookFileUploadEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "file_upload.created",
                "description": "Always `file_upload.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity"
            ],
            "type": "object"
          }
        ]
      },
      "fileUploadExpiredWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "entity": {
                "$ref": "#/components/schemas/webhookFileUploadEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "file_upload.expired",
                "description": "Always `file_upload.expired`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity"
            ],
            "type": "object"
          }
        ]
      },
      "fileUploadIdRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idRequest"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "fileUploadObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "complete_url": {
            "type": "string"
          },
          "content_length": {
            "oneOf": [
              {
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "content_type": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_by": {
            "additionalProperties": true,
            "properties": {
              "id": {
                "$ref": "#/components/schemas/idResponse"
              },
              "type": {
                "description": "One of: `person`, `bot`, `agent`",
                "enum": [
                  "person",
                  "bot",
                  "agent"
                ],
                "type": "string"
              }
            },
            "required": [
              "id",
              "type"
            ],
            "type": "object"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "expiry_time": {
            "oneOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "file_import_result": {
            "allOf": [
              {
                "additionalProperties": true,
                "properties": {
                  "imported_time": {
                    "description": "The time the file was imported into Notion. ISO 8601 format.",
                    "format": "date-time",
                    "type": "string"
                  }
                },
                "required": [
                  "imported_time"
                ],
                "type": "object"
              },
              {
                "oneOf": [
                  {
                    "properties": {
                      "success": {
                        "$ref": "#/components/schemas/CompatibleResponseemptyObject",
                        "description": "Empty object for success type."
                      },
                      "type": {
                        "const": "success",
                        "description": "Indicates a successful import.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "success"
                    ],
                    "title": "Success",
                    "type": "object"
                  },
                  {
                    "properties": {
                      "error": {
                        "additionalProperties": true,
                        "description": "Details about the error that occurred during file import.",
                        "properties": {
                          "code": {
                            "description": "A short string code representing the error.",
                            "type": "string"
                          },
                          "message": {
                            "description": "A human-readable message describing the error.",
                            "type": "string"
                          },
                          "parameter": {
                            "description": "The parameter related to the error, if applicable. Null if not applicable.",
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "status_code": {
                            "description": "The HTTP status code associated with the error, if available. Null if not applicable.",
                            "oneOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "type": {
                            "description": "The type of error that occurred during file import.",
                            "enum": [
                              "validation_error",
                              "internal_system_error",
                              "download_error",
                              "upload_error"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "code",
                          "message",
                          "parameter",
                          "status_code"
                        ],
                        "type": "object"
                      },
                      "type": {
                        "const": "error",
                        "description": "Indicates an error occurred during import.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "error"
                    ],
                    "title": "Error",
                    "type": "object"
                  }
                ]
              }
            ]
          },
          "filename": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "number_of_parts": {
            "additionalProperties": true,
            "properties": {
              "sent": {
                "minimum": 0,
                "type": "integer"
              },
              "total": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "total",
              "sent"
            ],
            "type": "object"
          },
          "object": {
            "const": "file_upload",
            "description": "Always `file_upload`",
            "type": "string"
          },
          "status": {
            "description": "One of: `pending`, `uploaded`, `expired`, `failed`",
            "enum": [
              "pending",
              "uploaded",
              "expired",
              "failed"
            ],
            "type": "string"
          },
          "upload_url": {
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "in_trash",
          "expiry_time",
          "status",
          "filename",
          "content_type",
          "content_length"
        ],
        "type": "object"
      },
      "fileUploadPageCoverRequest": {
        "properties": {
          "file_upload": {
            "description": "The file upload for the cover.",
            "properties": {
              "id": {
                "description": "ID of a FileUpload object that has the status `uploaded`.",
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "type": {
            "const": "file_upload",
            "description": "Always `file_upload`",
            "type": "string"
          }
        },
        "required": [
          "file_upload"
        ],
        "title": "File Upload",
        "type": "object"
      },
      "fileUploadPageIconRequest": {
        "properties": {
          "file_upload": {
            "properties": {
              "id": {
                "description": "ID of a FileUpload object that has the status `uploaded`.",
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "type": {
            "const": "file_upload",
            "description": "Always `file_upload`",
            "type": "string"
          }
        },
        "required": [
          "file_upload"
        ],
        "title": "File Upload",
        "type": "object"
      },
      "fileUploadUploadFailedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "file_import_result": {
                    "description": "The result of the file import attempt.",
                    "oneOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "imported_time": {
                            "description": "ISO 8601 timestamp of when the file was imported.",
                            "type": "string"
                          },
                          "success": {
                            "$ref": "#/components/schemas/emptyObject",
                            "description": "Empty object indicating success."
                          },
                          "type": {
                            "const": "success",
                            "description": "Always `success`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "imported_time",
                          "success"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "error": {
                            "additionalProperties": false,
                            "description": "Details about the error.",
                            "properties": {
                              "code": {
                                "description": "A machine-readable error code.",
                                "type": "string"
                              },
                              "message": {
                                "description": "A human-readable description of the error.",
                                "type": "string"
                              },
                              "parameter": {
                                "description": "The parameter that caused the error, or `null`.",
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "status_code": {
                                "description": "The HTTP status code associated with the error, or `null`.",
                                "oneOf": [
                                  {
                                    "type": "integer"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "type": {
                                "description": "The category of the error.",
                                "enum": [
                                  "validation_error",
                                  "internal_system_error",
                                  "download_error",
                                  "upload_error"
                                ],
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "code",
                              "message",
                              "parameter",
                              "status_code"
                            ],
                            "type": "object"
                          },
                          "imported_time": {
                            "description": "ISO 8601 timestamp of when the import was attempted.",
                            "type": "string"
                          },
                          "type": {
                            "const": "error",
                            "description": "Always `error`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "imported_time",
                          "error"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "required": [
                  "file_import_result"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookFileUploadEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "file_upload.upload_failed",
                "description": "Always `file_upload.upload_failed`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "fileUploadWithOptionalNameRequest": {
        "additionalProperties": false,
        "properties": {
          "file_upload": {
            "$ref": "#/components/schemas/fileUploadIdRequest"
          },
          "name": {
            "$ref": "#/components/schemas/stringRequest"
          },
          "type": {
            "const": "file_upload",
            "type": "string"
          }
        },
        "required": [
          "file_upload"
        ],
        "type": "object"
      },
      "filesDatabasePropertyConfigResponse": {
        "properties": {
          "files": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "files",
            "description": "Always `files`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "files"
        ],
        "title": "Files",
        "type": "object"
      },
      "filesPropertyConfigurationRequest": {
        "properties": {
          "files": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "files",
            "description": "Always `files`",
            "type": "string"
          }
        },
        "required": [
          "files"
        ],
        "title": "Files",
        "type": "object"
      },
      "filesPropertyItemObjectResponse": {
        "properties": {
          "files": {
            "items": {
              "$ref": "#/components/schemas/internalOrExternalFileWithNameResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "files",
            "type": "string"
          }
        },
        "required": [
          "type",
          "files",
          "object",
          "id"
        ],
        "title": "Files",
        "type": "object"
      },
      "filesSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "files": {
            "items": {
              "$ref": "#/components/schemas/internalOrExternalFileWithNameResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "files",
            "description": "Always `files`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "files"
        ],
        "title": "Files",
        "type": "object"
      },
      "formViewConfigRequest": {
        "properties": {
          "anonymous_submissions": {
            "description": "Whether anonymous (non-logged-in) submissions are allowed. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_form_closed": {
            "description": "Whether the form is closed for submissions. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "submission_permissions": {
            "description": "Permission level granted to the submitter on the created page after form submission. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `none`, `comment_only`, `reader`, `read_and_write`, `editor`",
                "enum": [
                  "none",
                  "comment_only",
                  "reader",
                  "read_and_write",
                  "editor"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "form",
            "description": "The view type. Must be \"form\".",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "formViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "anonymous_submissions": {
            "description": "Whether anonymous (non-logged-in) submissions are allowed.",
            "type": "boolean"
          },
          "is_form_closed": {
            "description": "Whether the form is closed for submissions.",
            "type": "boolean"
          },
          "submission_permissions": {
            "description": "Permission level granted to the submitter on the created page after form submission.",
            "enum": [
              "none",
              "comment_only",
              "reader",
              "read_and_write",
              "editor"
            ],
            "type": "string"
          },
          "type": {
            "const": "form",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "formulaCheckboxSubGroupByRequest": {
        "properties": {
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "checkbox",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "sort"
        ],
        "type": "object"
      },
      "formulaCheckboxSubGroupByResponse": {
        "additionalProperties": true,
        "properties": {
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (only manual for checkbox)."
          },
          "type": {
            "const": "checkbox",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "sort"
        ],
        "type": "object"
      },
      "formulaDatabasePropertyConfigResponse": {
        "properties": {
          "formula": {
            "additionalProperties": true,
            "properties": {
              "expression": {
                "type": "string"
              }
            },
            "required": [
              "expression"
            ],
            "type": "object"
          },
          "type": {
            "const": "formula",
            "description": "Always `formula`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "formula"
        ],
        "title": "Formula",
        "type": "object"
      },
      "formulaDateSubGroupByRequest": {
        "properties": {
          "group_by": {
            "description": "Granularity for date grouping.",
            "enum": [
              "relative",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "start_day_of_week": {
            "description": "Start day of week for week grouping (0 = Sunday, 1 = Monday).",
            "enum": [
              0,
              1
            ],
            "type": "number"
          },
          "type": {
            "const": "date",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "formulaDateSubGroupByResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "description": "Granularity for date grouping.",
            "enum": [
              "relative",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "start_day_of_week": {
            "description": "Start day of week for week grouping (0 = Sunday, 1 = Monday).",
            "enum": [
              0,
              1
            ],
            "type": "number"
          },
          "type": {
            "const": "date",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "formulaGroupByConfigRequest": {
        "properties": {
          "group_by": {
            "description": "Sub-group-by configuration based on the formula result type.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/formulaDateSubGroupByRequest"
              },
              {
                "$ref": "#/components/schemas/formulaTextSubGroupByRequest"
              },
              {
                "$ref": "#/components/schemas/formulaNumberSubGroupByRequest"
              },
              {
                "$ref": "#/components/schemas/formulaCheckboxSubGroupByRequest"
              }
            ]
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID of the formula to group by.",
            "type": "string"
          },
          "type": {
            "const": "formula",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by"
        ],
        "type": "object"
      },
      "formulaGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "$ref": "#/components/schemas/formulaSubGroupByResponse",
            "description": "Sub-group-by configuration based on the formula result type."
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID of the formula to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "type": {
            "const": "formula",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by"
        ],
        "type": "object"
      },
      "formulaNumberSubGroupByRequest": {
        "properties": {
          "range_end": {
            "description": "End of the range for number grouping buckets.",
            "type": "integer"
          },
          "range_size": {
            "description": "Size of each bucket in number grouping.",
            "minimum": 1,
            "type": "integer"
          },
          "range_start": {
            "description": "Start of the range for number grouping buckets.",
            "type": "integer"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "number",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "sort"
        ],
        "type": "object"
      },
      "formulaNumberSubGroupByResponse": {
        "additionalProperties": true,
        "properties": {
          "range_end": {
            "description": "End of the range for number grouping buckets.",
            "type": "integer"
          },
          "range_size": {
            "description": "Size of each bucket in number grouping.",
            "minimum": 1,
            "type": "integer"
          },
          "range_start": {
            "description": "Start of the range for number grouping buckets.",
            "type": "integer"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (ascending or descending only)."
          },
          "type": {
            "const": "number",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "sort"
        ],
        "type": "object"
      },
      "formulaPropertyConfigurationRequest": {
        "properties": {
          "formula": {
            "properties": {
              "expression": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": {
            "const": "formula",
            "description": "Always `formula`",
            "type": "string"
          }
        },
        "required": [
          "formula"
        ],
        "title": "Formula",
        "type": "object"
      },
      "formulaPropertyFilter": {
        "anyOf": [
          {
            "properties": {
              "string": {
                "$ref": "#/components/schemas/textPropertyFilter"
              }
            },
            "required": [
              "string"
            ],
            "type": "object"
          },
          {
            "properties": {
              "checkbox": {
                "$ref": "#/components/schemas/checkboxPropertyFilter"
              }
            },
            "required": [
              "checkbox"
            ],
            "type": "object"
          },
          {
            "properties": {
              "number": {
                "$ref": "#/components/schemas/numberPropertyFilter"
              }
            },
            "required": [
              "number"
            ],
            "type": "object"
          },
          {
            "properties": {
              "date": {
                "$ref": "#/components/schemas/datePropertyFilter"
              }
            },
            "required": [
              "date"
            ],
            "type": "object"
          }
        ]
      },
      "formulaPropertyItemObjectResponse": {
        "properties": {
          "formula": {
            "$ref": "#/components/schemas/formulaPropertyResponse"
          },
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "formula",
            "type": "string"
          }
        },
        "required": [
          "type",
          "formula",
          "object",
          "id"
        ],
        "title": "Formula",
        "type": "object"
      },
      "formulaPropertyResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/stringFormulaPropertyResponse"
          },
          {
            "$ref": "#/components/schemas/dateFormulaPropertyResponse"
          },
          {
            "$ref": "#/components/schemas/numberFormulaPropertyResponse"
          },
          {
            "$ref": "#/components/schemas/booleanFormulaPropertyResponse"
          },
          {
            "$ref": "#/components/schemas/unsupportedFormulaPropertyResponse"
          }
        ]
      },
      "formulaPropertyValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/booleanFormulaPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/dateFormulaPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/numberFormulaPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/stringFormulaPropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/unsupportedFormulaPropertyValueResponse"
          }
        ]
      },
      "formulaSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "formula": {
            "$ref": "#/components/schemas/formulaPropertyValueResponse"
          },
          "type": {
            "const": "formula",
            "description": "Always `formula`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "formula"
        ],
        "title": "Formula",
        "type": "object"
      },
      "formulaSubGroupByResponse": {
        "description": "Sub-group-by configuration for formula properties based on result type.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/formulaDateSubGroupByResponse"
          },
          {
            "$ref": "#/components/schemas/formulaTextSubGroupByResponse"
          },
          {
            "$ref": "#/components/schemas/formulaNumberSubGroupByResponse"
          },
          {
            "$ref": "#/components/schemas/formulaCheckboxSubGroupByResponse"
          }
        ]
      },
      "formulaTextSubGroupByRequest": {
        "properties": {
          "group_by": {
            "description": "How to group text values. \"exact\" = exact match, \"alphabet_prefix\" = first letter.",
            "enum": [
              "exact",
              "alphabet_prefix"
            ],
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "text",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "formulaTextSubGroupByResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "description": "How to group text values. \"exact\" = exact match, \"alphabet_prefix\" = first letter.",
            "enum": [
              "exact",
              "alphabet_prefix"
            ],
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "text",
            "description": "The formula result type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "galleryViewConfigRequest": {
        "properties": {
          "card_layout": {
            "description": "Card layout mode. \"list\" shows full cards, \"compact\" shows condensed cards. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `list`, `compact`",
                "enum": [
                  "list",
                  "compact"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover": {
            "description": "Cover image configuration for cards. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/coverConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover_aspect": {
            "description": "Aspect ratio mode for cover images. \"contain\" fits the image, \"cover\" fills the area. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `contain`, `cover`",
                "enum": [
                  "contain",
                  "cover"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover_size": {
            "description": "Size of the cover image on cards. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `small`, `medium`, `large`",
                "enum": [
                  "small",
                  "medium",
                  "large"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "properties": {
            "description": "Property visibility and display configuration on gallery cards. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "gallery",
            "description": "The view type. Must be \"gallery\".",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "galleryViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "card_layout": {
            "description": "Card layout mode (list shows all properties, compact shows inline).",
            "enum": [
              "list",
              "compact"
            ],
            "type": "string"
          },
          "cover": {
            "$ref": "#/components/schemas/coverConfigResponse",
            "description": "Card cover/preview image configuration."
          },
          "cover_aspect": {
            "description": "Cover image aspect ratio.",
            "enum": [
              "contain",
              "cover"
            ],
            "type": "string"
          },
          "cover_size": {
            "description": "Cover image size.",
            "enum": [
              "small",
              "medium",
              "large"
            ],
            "type": "string"
          },
          "properties": {
            "description": "Properties to display on gallery cards.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "gallery",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "groupByConfigRequest": {
        "description": "Group-by configuration based on property type.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/selectGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/statusGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/personGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/relationGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/dateGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/textGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/numberGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/checkboxGroupByConfigRequest"
          },
          {
            "$ref": "#/components/schemas/formulaGroupByConfigRequest"
          }
        ]
      },
      "groupByConfigResponse": {
        "description": "Group-by configuration based on property type.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/selectGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/statusGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/personGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/relationGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/dateGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/textGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/numberGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/checkboxGroupByConfigResponse"
          },
          {
            "$ref": "#/components/schemas/formulaGroupByConfigResponse"
          }
        ]
      },
      "groupFilterOperatorArray": {
        "items": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/propertyOrTimestampFilter"
            },
            {
              "anyOf": [
                {
                  "properties": {
                    "or": {
                      "$ref": "#/components/schemas/propertyOrTimestampFilterArray"
                    }
                  },
                  "required": [
                    "or"
                  ],
                  "type": "object"
                },
                {
                  "properties": {
                    "and": {
                      "$ref": "#/components/schemas/propertyOrTimestampFilterArray"
                    }
                  },
                  "required": [
                    "and"
                  ],
                  "type": "object"
                }
              ]
            }
          ]
        },
        "maxItems": 100,
        "type": "array"
      },
      "groupObjectRequest": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idRequest"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "object": {
            "const": "group",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "groupObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the group."
          },
          "name": {
            "description": "The name of the group.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "object": {
            "const": "group",
            "description": "The group object type name.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "object",
          "name"
        ],
        "type": "object"
      },
      "groupSortRequest": {
        "properties": {
          "type": {
            "description": "Sort direction for groups.",
            "enum": [
              "manual",
              "ascending",
              "descending"
            ],
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "groupSortResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "description": "Sort direction for groups.",
            "enum": [
              "manual",
              "ascending",
              "descending"
            ],
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "headerContentWithRichTextAndColorRequest": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "is_toggleable": {
            "type": "boolean"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "headerContentWithRichTextAndColorResponse": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseapiColor"
          },
          "is_toggleable": {
            "type": "boolean"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text",
          "color",
          "is_toggleable"
        ],
        "type": "object"
      },
      "headerContentWithSingleLevelOfChildrenRequest": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
            },
            "maxItems": 100,
            "type": "array"
          },
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "is_toggleable": {
            "type": "boolean"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "heading1BlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "heading_1": {
            "$ref": "#/components/schemas/headerContentWithRichTextAndColorResponse"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "heading_1",
            "type": "string"
          }
        },
        "required": [
          "type",
          "heading_1",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Heading 1",
        "type": "object"
      },
      "heading2BlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "heading_2": {
            "$ref": "#/components/schemas/headerContentWithRichTextAndColorResponse"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "heading_2",
            "type": "string"
          }
        },
        "required": [
          "type",
          "heading_2",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Heading 2",
        "type": "object"
      },
      "heading3BlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "heading_3": {
            "$ref": "#/components/schemas/headerContentWithRichTextAndColorResponse"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "heading_3",
            "type": "string"
          }
        },
        "required": [
          "type",
          "heading_3",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Heading 3",
        "type": "object"
      },
      "heading4BlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "heading_4": {
            "$ref": "#/components/schemas/headerContentWithRichTextAndColorResponse"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "heading_4",
            "type": "string"
          }
        },
        "required": [
          "type",
          "heading_4",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Heading 4",
        "type": "object"
      },
      "iconPageIconRequest": {
        "properties": {
          "icon": {
            "description": "A Notion native icon, specified by name and optional color.",
            "properties": {
              "color": {
                "$ref": "#/components/schemas/noticonColor",
                "description": "The color variant of the icon. Defaults to gray if not specified. Valid values: gray, lightgray, brown, yellow, orange, green, blue, purple, pink, red."
              },
              "name": {
                "$ref": "#/components/schemas/noticonName",
                "description": "The name of the Notion icon (e.g. pizza, meeting, home). See the Notion icon picker for valid names."
              }
            },
            "required": [
              "name"
            ],
            "type": "object"
          },
          "type": {
            "const": "icon",
            "description": "Always `icon`",
            "type": "string"
          }
        },
        "required": [
          "icon"
        ],
        "title": "Icon",
        "type": "object"
      },
      "iconPageIconResponse": {
        "additionalProperties": true,
        "properties": {
          "icon": {
            "$ref": "#/components/schemas/noticonIconResponse",
            "description": "The Notion native icon, specified by name and color."
          },
          "type": {
            "const": "icon",
            "description": "Type of icon. In this case, a Notion native icon.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "icon"
        ],
        "title": "Icon",
        "type": "object"
      },
      "idObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "idRequest": {
        "type": "string"
      },
      "idResponse": {
        "format": "uuid",
        "type": "string"
      },
      "imageBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "image": {
            "$ref": "#/components/schemas/mediaContentWithFileAndCaptionResponse"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "image",
            "type": "string"
          }
        },
        "required": [
          "type",
          "image",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Image",
        "type": "object"
      },
      "initialDataSourceRequest": {
        "properties": {
          "properties": {
            "additionalProperties": {
              "$ref": "#/components/schemas/propertyConfigurationRequest"
            },
            "description": "Property schema for the initial data source, if you'd like to create one.",
            "type": "object"
          }
        },
        "type": "object"
      },
      "internalFileRequest": {
        "additionalProperties": false,
        "properties": {
          "expiry_time": {
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "internalFileResponse": {
        "additionalProperties": true,
        "properties": {
          "expiry_time": {
            "description": "The time when the URL will expire.",
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "The URL of the file.",
            "type": "string"
          }
        },
        "required": [
          "url",
          "expiry_time"
        ],
        "type": "object"
      },
      "internalOrExternalFileWithNameRequest": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "file": {
                "$ref": "#/components/schemas/internalFileRequest"
              },
              "name": {
                "$ref": "#/components/schemas/stringRequest"
              },
              "type": {
                "const": "file",
                "type": "string"
              }
            },
            "required": [
              "file",
              "name"
            ],
            "title": "File",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "external": {
                "$ref": "#/components/schemas/externalFileRequest"
              },
              "name": {
                "$ref": "#/components/schemas/stringRequest"
              },
              "type": {
                "const": "external",
                "type": "string"
              }
            },
            "required": [
              "external",
              "name"
            ],
            "title": "External",
            "type": "object"
          }
        ]
      },
      "internalOrExternalFileWithNameResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/internalOrExternalFileWithNameResponseCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/fileInternalOrExternalFileWithNameResponse"
              },
              {
                "$ref": "#/components/schemas/externalInternalOrExternalFileWithNameResponse"
              }
            ]
          }
        ]
      },
      "internalOrExternalFileWithNameResponseCommon": {
        "additionalProperties": true,
        "properties": {
          "name": {
            "description": "The name of the file.",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "languageRequest": {
        "enum": [
          "abap",
          "abc",
          "agda",
          "arduino",
          "ascii art",
          "assembly",
          "bash",
          "basic",
          "bnf",
          "c",
          "c#",
          "c++",
          "clojure",
          "coffeescript",
          "coq",
          "css",
          "dart",
          "dhall",
          "diff",
          "docker",
          "ebnf",
          "elixir",
          "elm",
          "erlang",
          "f#",
          "flow",
          "fortran",
          "gherkin",
          "glsl",
          "go",
          "graphql",
          "groovy",
          "haskell",
          "hcl",
          "html",
          "idris",
          "java",
          "javascript",
          "json",
          "julia",
          "kotlin",
          "latex",
          "less",
          "lisp",
          "livescript",
          "llvm ir",
          "lua",
          "makefile",
          "markdown",
          "markup",
          "matlab",
          "mathematica",
          "mermaid",
          "nix",
          "notion formula",
          "objective-c",
          "ocaml",
          "pascal",
          "perl",
          "php",
          "plain text",
          "powershell",
          "prolog",
          "protobuf",
          "purescript",
          "python",
          "r",
          "racket",
          "reason",
          "ruby",
          "rust",
          "sass",
          "scala",
          "scheme",
          "scss",
          "shell",
          "smalltalk",
          "solidity",
          "sql",
          "swift",
          "toml",
          "typescript",
          "vb.net",
          "verilog",
          "vhdl",
          "visual basic",
          "webassembly",
          "xml",
          "yaml",
          "java/c/c++/c#"
        ],
        "type": "string"
      },
      "lastEditedByDatabasePropertyConfigResponse": {
        "properties": {
          "last_edited_by": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "last_edited_by",
            "description": "Always `last_edited_by`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_by"
        ],
        "title": "Last Edited By",
        "type": "object"
      },
      "lastEditedByPropertyConfigurationRequest": {
        "properties": {
          "last_edited_by": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "last_edited_by",
            "description": "Always `last_edited_by`",
            "type": "string"
          }
        },
        "required": [
          "last_edited_by"
        ],
        "title": "Last Edited By",
        "type": "object"
      },
      "lastEditedByPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "last_edited_by": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/partialUserObjectResponse"
              },
              {
                "$ref": "#/components/schemas/userObjectResponse"
              }
            ]
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "last_edited_by",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_by",
          "object",
          "id"
        ],
        "title": "Last Edited By",
        "type": "object"
      },
      "lastEditedBySimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "last_edited_by": {
            "$ref": "#/components/schemas/userValueResponse"
          },
          "type": {
            "const": "last_edited_by",
            "description": "Always `last_edited_by`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_by"
        ],
        "title": "Last Edited By",
        "type": "object"
      },
      "lastEditedTimeDatabasePropertyConfigResponse": {
        "properties": {
          "last_edited_time": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "last_edited_time",
            "description": "Always `last_edited_time`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_time"
        ],
        "title": "Last Edited Time",
        "type": "object"
      },
      "lastEditedTimePropertyConfigurationRequest": {
        "properties": {
          "last_edited_time": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "last_edited_time",
            "description": "Always `last_edited_time`",
            "type": "string"
          }
        },
        "required": [
          "last_edited_time"
        ],
        "title": "Last Edited Time",
        "type": "object"
      },
      "lastEditedTimePropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "last_edited_time",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_time",
          "object",
          "id"
        ],
        "title": "Last Edited Time",
        "type": "object"
      },
      "lastEditedTimeSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "type": {
            "const": "last_edited_time",
            "description": "Always `last_edited_time`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "last_edited_time"
        ],
        "title": "Last Edited Time",
        "type": "object"
      },
      "lastVisitedTimePropertyConfigurationRequest": {
        "properties": {
          "last_visited_time": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "last_visited_time",
            "description": "Always `last_visited_time`",
            "type": "string"
          }
        },
        "required": [
          "last_visited_time"
        ],
        "title": "Last Visited Time",
        "type": "object"
      },
      "linkMentionResponse": {
        "additionalProperties": true,
        "properties": {
          "description": {
            "description": "The description of the link.",
            "type": "string"
          },
          "height": {
            "description": "The height of the link preview iframe.",
            "type": "integer"
          },
          "href": {
            "description": "The href of the link mention.",
            "type": "string"
          },
          "icon_url": {
            "description": "The icon URL of the link.",
            "type": "string"
          },
          "iframe_url": {
            "description": "The iframe URL of the link.",
            "type": "string"
          },
          "link_author": {
            "description": "The author of the link.",
            "type": "string"
          },
          "link_provider": {
            "description": "The provider of the link.",
            "type": "string"
          },
          "padding": {
            "description": "The padding of the link preview iframe.",
            "type": "integer"
          },
          "padding_top": {
            "description": "The top padding of the link preview iframe.",
            "type": "integer"
          },
          "thumbnail_url": {
            "description": "The thumbnail URL of the link.",
            "type": "string"
          },
          "title": {
            "description": "The title of the link.",
            "type": "string"
          }
        },
        "required": [
          "href"
        ],
        "type": "object"
      },
      "linkPreviewBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "link_preview": {
            "$ref": "#/components/schemas/mediaContentWithUrlResponse"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "link_preview",
            "type": "string"
          }
        },
        "required": [
          "type",
          "link_preview",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Link Preview",
        "type": "object"
      },
      "linkPreviewMentionResponse": {
        "additionalProperties": true,
        "properties": {
          "url": {
            "description": "The URL of the link preview mention.",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "linkToPageBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "link_to_page": {
            "anyOf": [
              {
                "properties": {
                  "page_id": {
                    "$ref": "#/components/schemas/CompatibleResponseidRequest"
                  },
                  "type": {
                    "const": "page_id",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "page_id"
                ],
                "title": "Page Id",
                "type": "object"
              },
              {
                "properties": {
                  "database_id": {
                    "$ref": "#/components/schemas/CompatibleResponseidRequest"
                  },
                  "type": {
                    "const": "database_id",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "database_id"
                ],
                "title": "Database Id",
                "type": "object"
              },
              {
                "properties": {
                  "comment_id": {
                    "$ref": "#/components/schemas/CompatibleResponseidRequest"
                  },
                  "type": {
                    "const": "comment_id",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "comment_id"
                ],
                "title": "Comment Id",
                "type": "object"
              }
            ]
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "link_to_page",
            "type": "string"
          }
        },
        "required": [
          "type",
          "link_to_page",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Link To Page",
        "type": "object"
      },
      "listViewConfigRequest": {
        "properties": {
          "properties": {
            "description": "Property visibility and display configuration. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "list",
            "description": "The view type. Must be \"list\".",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "listViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "properties": {
            "description": "Properties to display in list items.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "list",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "locationPropertyConfigurationRequest": {
        "properties": {
          "location": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "location",
            "description": "Always `location`",
            "type": "string"
          }
        },
        "required": [
          "location"
        ],
        "title": "Location",
        "type": "object"
      },
      "mapViewConfigRequest": {
        "properties": {
          "height": {
            "description": "Map display height. Pass null to clear.",
            "oneOf": [
              {
                "description": "One of: `small`, `medium`, `large`, `extra_large`",
                "enum": [
                  "small",
                  "medium",
                  "large",
                  "extra_large"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "map_by": {
            "description": "Property ID of the location property used to position items on the map. Pass null to clear.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "properties": {
            "description": "Property visibility and display configuration on map pin cards. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "map",
            "description": "The view type. Must be \"map\".",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "mapViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "height": {
            "description": "Map display height.",
            "enum": [
              "small",
              "medium",
              "large",
              "extra_large"
            ],
            "type": "string"
          },
          "map_by": {
            "description": "Property ID of the location property used to position items on the map.",
            "type": "string"
          },
          "map_by_property_name": {
            "description": "Map-by property name (convenience field).",
            "type": "string"
          },
          "properties": {
            "description": "Properties to display on map pin cards.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "map",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "mediaContentWithFileAndCaptionRequest": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "caption": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              "external": {
                "$ref": "#/components/schemas/externalFileRequest"
              },
              "type": {
                "const": "external",
                "type": "string"
              }
            },
            "required": [
              "external"
            ],
            "title": "External",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "caption": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              "file_upload": {
                "$ref": "#/components/schemas/fileUploadIdRequest"
              },
              "type": {
                "const": "file_upload",
                "type": "string"
              }
            },
            "required": [
              "file_upload"
            ],
            "title": "File Upload",
            "type": "object"
          }
        ]
      },
      "mediaContentWithFileAndCaptionResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/externalMediaContentWithFileAndCaptionResponse"
          },
          {
            "$ref": "#/components/schemas/fileMediaContentWithFileAndCaptionResponse"
          }
        ]
      },
      "mediaContentWithFileNameAndCaptionRequest": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "caption": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              "external": {
                "$ref": "#/components/schemas/externalFileRequest"
              },
              "name": {
                "$ref": "#/components/schemas/stringRequest"
              },
              "type": {
                "const": "external",
                "type": "string"
              }
            },
            "required": [
              "external"
            ],
            "title": "External",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "caption": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              "file_upload": {
                "$ref": "#/components/schemas/fileUploadIdRequest"
              },
              "name": {
                "$ref": "#/components/schemas/stringRequest"
              },
              "type": {
                "const": "file_upload",
                "type": "string"
              }
            },
            "required": [
              "file_upload"
            ],
            "title": "File Upload",
            "type": "object"
          }
        ]
      },
      "mediaContentWithFileNameAndCaptionResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/externalMediaContentWithFileNameAndCaptionResponse"
          },
          {
            "$ref": "#/components/schemas/fileMediaContentWithFileNameAndCaptionResponse"
          }
        ]
      },
      "mediaContentWithUrlAndCaptionRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "mediaContentWithUrlAndCaptionResponse": {
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "caption"
        ],
        "type": "object"
      },
      "mediaContentWithUrlResponse": {
        "properties": {
          "url": {
            "$ref": "#/components/schemas/CompatibleResponsetextRequest"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "meetingNotesBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "meeting_notes": {
            "$ref": "#/components/schemas/transcriptionBlockResponse"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "meeting_notes",
            "type": "string"
          }
        },
        "required": [
          "type",
          "meeting_notes",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Meeting Notes",
        "type": "object"
      },
      "meetingNotesPropertyFilter": {
        "additionalProperties": false,
        "properties": {
          "filter": {
            "description": "The comparison to apply. Use the arm matching the property's type.",
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "operator": {
                    "description": "How to compare the text.",
                    "enum": [
                      "string_is",
                      "string_is_not",
                      "string_contains",
                      "string_does_not_contain",
                      "string_starts_with",
                      "string_ends_with"
                    ],
                    "type": "string"
                  },
                  "value": {
                    "additionalProperties": false,
                    "description": "The text to compare against.",
                    "properties": {
                      "type": {
                        "const": "exact",
                        "description": "Always `exact`",
                        "type": "string"
                      },
                      "value": {
                        "description": "The literal text the operator compares against.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "value"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "operator": {
                    "description": "Whether the property must contain the people listed.",
                    "enum": [
                      "person_contains",
                      "person_does_not_contain"
                    ],
                    "type": "string"
                  },
                  "value": {
                    "description": "The people to compare against.",
                    "items": {
                      "oneOf": [
                        {
                          "additionalProperties": false,
                          "properties": {
                            "type": {
                              "const": "exact",
                              "description": "Always `exact`",
                              "type": "string"
                            },
                            "value": {
                              "additionalProperties": false,
                              "description": "Pointer to the Notion user to match.",
                              "properties": {
                                "id": {
                                  "description": "The user's ID, as a UUID or the `user://<uuid>` form returned by user search.",
                                  "examples": [
                                    "3f2b25f3-0a52-4a90-8f0d-5a3f0e6c1d2e",
                                    "user://3f2b25f3-0a52-4a90-8f0d-5a3f0e6c1d2e"
                                  ],
                                  "type": "string"
                                },
                                "table": {
                                  "const": "notion_user",
                                  "description": "Always `notion_user`",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "table",
                                "id"
                              ],
                              "type": "object"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": false,
                          "properties": {
                            "type": {
                              "const": "relative",
                              "description": "Always `relative`",
                              "type": "string"
                            },
                            "value": {
                              "const": "me",
                              "description": "Always `me`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "value"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "operator": {
                    "description": "How to compare the date.",
                    "enum": [
                      "date_is",
                      "date_is_before",
                      "date_is_after",
                      "date_is_on_or_before",
                      "date_is_on_or_after"
                    ],
                    "type": "string"
                  },
                  "use_end": {
                    "description": "Compare against the end of a date range rather than its start.",
                    "type": "boolean"
                  },
                  "value": {
                    "description": "The date to compare against.",
                    "oneOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "relative",
                            "description": "Always `relative`",
                            "type": "string"
                          },
                          "value": {
                            "description": "One of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`",
                            "enum": [
                              "today",
                              "tomorrow",
                              "yesterday",
                              "one_week_ago",
                              "one_week_from_now",
                              "one_month_ago",
                              "one_month_from_now"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "exact",
                            "description": "Always `exact`",
                            "type": "string"
                          },
                          "value": {
                            "description": "Use the is_empty operator to match an unset date.",
                            "oneOf": [
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "start_date": {
                                    "description": "The calendar date as an ISO 8601 date string.",
                                    "examples": [
                                      "1990-12-28"
                                    ],
                                    "format": "date",
                                    "type": "string"
                                  },
                                  "type": {
                                    "const": "date",
                                    "description": "Always `date`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type",
                                  "start_date"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "start_date": {
                                    "description": "The calendar date as an ISO 8601 date string.",
                                    "examples": [
                                      "1990-12-28"
                                    ],
                                    "format": "date",
                                    "type": "string"
                                  },
                                  "start_time": {
                                    "description": "The time of day in 24-hour HH:MM format.",
                                    "examples": [
                                      "09:30"
                                    ],
                                    "type": "string"
                                  },
                                  "time_zone": {
                                    "description": "The IANA time zone name the time is interpreted in.",
                                    "examples": [
                                      "America/Los_Angeles"
                                    ],
                                    "type": "string"
                                  },
                                  "type": {
                                    "const": "datetime",
                                    "description": "Always `datetime`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type",
                                  "start_date",
                                  "start_time",
                                  "time_zone"
                                ],
                                "type": "object"
                              }
                            ]
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "operator": {
                    "description": "How to compare the date against the range.",
                    "enum": [
                      "date_is_within",
                      "date_is_relative_to"
                    ],
                    "type": "string"
                  },
                  "use_end": {
                    "description": "Compare against the end of a date range rather than its start.",
                    "type": "boolean"
                  },
                  "value": {
                    "description": "The range to compare against.",
                    "oneOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "count": {
                            "description": "How many units wide the window is.",
                            "minimum": 1,
                            "type": "integer"
                          },
                          "direction": {
                            "description": "Whether the window runs backwards or forwards from now.",
                            "enum": [
                              "past",
                              "future"
                            ],
                            "type": "string"
                          },
                          "type": {
                            "const": "relative",
                            "description": "Always `relative`",
                            "type": "string"
                          },
                          "unit": {
                            "description": "One of: `year`, `month`, `week`, `day`",
                            "enum": [
                              "year",
                              "month",
                              "week",
                              "day"
                            ],
                            "type": "string"
                          },
                          "value": {
                            "const": "custom",
                            "description": "Always `custom`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value",
                          "direction",
                          "unit",
                          "count"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "relative",
                            "description": "Always `relative`",
                            "type": "string"
                          },
                          "unit": {
                            "description": "One of: `year`, `month`, `week`, `day`",
                            "enum": [
                              "year",
                              "month",
                              "week",
                              "day"
                            ],
                            "type": "string"
                          },
                          "value": {
                            "const": "surrounding",
                            "description": "Always `surrounding`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value",
                          "unit"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "relative",
                            "description": "Always `relative`",
                            "type": "string"
                          },
                          "value": {
                            "description": "One of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`",
                            "enum": [
                              "this_week",
                              "the_past_week",
                              "the_past_month",
                              "the_past_year",
                              "the_next_week",
                              "the_next_month",
                              "the_next_year"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "exact",
                            "description": "Always `exact`",
                            "type": "string"
                          },
                          "value": {
                            "additionalProperties": false,
                            "description": "Use the is_empty operator to match an unset date.",
                            "properties": {
                              "end_date": {
                                "description": "Inclusive end of the range as an ISO 8601 date string, if any.",
                                "examples": [
                                  "1991-01-04"
                                ],
                                "format": "date",
                                "type": "string"
                              },
                              "start_date": {
                                "description": "Inclusive start of the range as an ISO 8601 date string, if any.",
                                "examples": [
                                  "1990-12-28"
                                ],
                                "format": "date",
                                "type": "string"
                              },
                              "type": {
                                "const": "daterange",
                                "description": "Always `daterange`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type"
                            ],
                            "type": "object"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "operator": {
                    "description": "Whether the property must be empty or set.",
                    "enum": [
                      "is_empty",
                      "is_not_empty"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "operator"
                ],
                "type": "object"
              }
            ]
          },
          "property": {
            "description": "Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.",
            "enum": [
              "title",
              "attendees",
              "created_time",
              "created_by",
              "last_edited_time",
              "last_edited_by",
              "notion://meeting_notes/attendees"
            ],
            "type": "string"
          }
        },
        "required": [
          "property",
          "filter"
        ],
        "type": "object"
      },
      "mentionRichTextItemRequest": {
        "properties": {
          "mention": {
            "description": "Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.",
            "oneOf": [
              {
                "properties": {
                  "type": {
                    "const": "user",
                    "description": "Always `user`",
                    "type": "string"
                  },
                  "user": {
                    "$ref": "#/components/schemas/partialUserObjectRequest",
                    "description": "Details of the user mention."
                  }
                },
                "required": [
                  "user"
                ],
                "title": "User",
                "type": "object"
              },
              {
                "properties": {
                  "date": {
                    "$ref": "#/components/schemas/dateRequest",
                    "description": "Details of the date mention."
                  },
                  "type": {
                    "const": "date",
                    "description": "Always `date`",
                    "type": "string"
                  }
                },
                "required": [
                  "date"
                ],
                "title": "Date",
                "type": "object"
              },
              {
                "properties": {
                  "page": {
                    "description": "Details of the page mention.",
                    "properties": {
                      "id": {
                        "$ref": "#/components/schemas/idRequest",
                        "description": "The ID of the page in the mention."
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  "type": {
                    "const": "page",
                    "description": "Always `page`",
                    "type": "string"
                  }
                },
                "required": [
                  "page"
                ],
                "title": "Page",
                "type": "object"
              },
              {
                "properties": {
                  "database": {
                    "description": "Details of the database mention.",
                    "properties": {
                      "id": {
                        "$ref": "#/components/schemas/idRequest",
                        "description": "The ID of the database in the mention."
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  "type": {
                    "const": "database",
                    "description": "Always `database`",
                    "type": "string"
                  }
                },
                "required": [
                  "database"
                ],
                "title": "Database",
                "type": "object"
              },
              {
                "properties": {
                  "template_mention": {
                    "$ref": "#/components/schemas/templateMentionRequest",
                    "description": "Details of the template mention."
                  },
                  "type": {
                    "const": "template_mention",
                    "description": "Always `template_mention`",
                    "type": "string"
                  }
                },
                "required": [
                  "template_mention"
                ],
                "title": "Template Mention",
                "type": "object"
              },
              {
                "properties": {
                  "custom_emoji": {
                    "description": "Details of the custom emoji mention.",
                    "properties": {
                      "id": {
                        "$ref": "#/components/schemas/idRequest",
                        "description": "The ID of the custom emoji."
                      },
                      "name": {
                        "description": "The name of the custom emoji.",
                        "type": "string"
                      },
                      "url": {
                        "description": "The URL of the custom emoji.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  "type": {
                    "const": "custom_emoji",
                    "description": "Always `custom_emoji`",
                    "type": "string"
                  }
                },
                "required": [
                  "custom_emoji"
                ],
                "title": "Custom Emoji",
                "type": "object"
              }
            ]
          },
          "type": {
            "const": "mention",
            "description": "Always `mention`",
            "type": "string"
          }
        },
        "required": [
          "mention"
        ],
        "title": "Mention",
        "type": "object"
      },
      "mentionRichTextItemResponse": {
        "properties": {
          "mention": {
            "description": "Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.",
            "oneOf": [
              {
                "additionalProperties": true,
                "properties": {
                  "type": {
                    "const": "user",
                    "description": "Always `user`",
                    "type": "string"
                  },
                  "user": {
                    "$ref": "#/components/schemas/userValueResponse",
                    "description": "Details of the user mention."
                  }
                },
                "required": [
                  "type",
                  "user"
                ],
                "title": "User",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "date": {
                    "$ref": "#/components/schemas/dateResponse",
                    "description": "Details of the date mention."
                  },
                  "type": {
                    "const": "date",
                    "description": "Always `date`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "date"
                ],
                "title": "Date",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "link_preview": {
                    "$ref": "#/components/schemas/linkPreviewMentionResponse",
                    "description": "Details of the link preview mention."
                  },
                  "type": {
                    "const": "link_preview",
                    "description": "Always `link_preview`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "link_preview"
                ],
                "title": "Link Preview",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "link_mention": {
                    "$ref": "#/components/schemas/linkMentionResponse",
                    "description": "Details of the link mention."
                  },
                  "type": {
                    "const": "link_mention",
                    "description": "Always `link_mention`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "link_mention"
                ],
                "title": "Link Mention",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "page": {
                    "additionalProperties": true,
                    "description": "Details of the page mention.",
                    "properties": {
                      "id": {
                        "$ref": "#/components/schemas/idResponse",
                        "description": "The ID of the page in the mention."
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  "type": {
                    "const": "page",
                    "description": "Always `page`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "page"
                ],
                "title": "Page",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "database": {
                    "additionalProperties": true,
                    "description": "Details of the database mention.",
                    "properties": {
                      "id": {
                        "$ref": "#/components/schemas/idResponse",
                        "description": "The ID of the database in the mention."
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  "type": {
                    "const": "database",
                    "description": "Always `database`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "database"
                ],
                "title": "Database",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "template_mention": {
                    "$ref": "#/components/schemas/templateMentionResponse",
                    "description": "Details of the template mention."
                  },
                  "type": {
                    "const": "template_mention",
                    "description": "Always `template_mention`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "template_mention"
                ],
                "title": "Template Mention",
                "type": "object"
              },
              {
                "additionalProperties": true,
                "properties": {
                  "custom_emoji": {
                    "$ref": "#/components/schemas/customEmojiResponse",
                    "description": "Details of the custom emoji mention."
                  },
                  "type": {
                    "const": "custom_emoji",
                    "description": "Always `custom_emoji`",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "custom_emoji"
                ],
                "title": "Custom Emoji",
                "type": "object"
              }
            ]
          },
          "type": {
            "const": "mention",
            "description": "Always `mention`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "mention"
        ],
        "title": "Mention",
        "type": "object"
      },
      "multiSelectDatabasePropertyConfigResponse": {
        "properties": {
          "multi_select": {
            "additionalProperties": true,
            "properties": {
              "options": {
                "items": {
                  "$ref": "#/components/schemas/selectPropertyResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "options"
            ],
            "type": "object"
          },
          "type": {
            "const": "multi_select",
            "description": "Always `multi_select`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "multi_select"
        ],
        "title": "Multi Select",
        "type": "object"
      },
      "multiSelectPropertyConfigurationRequest": {
        "properties": {
          "multi_select": {
            "properties": {
              "options": {
                "items": {
                  "properties": {
                    "color": {
                      "$ref": "#/components/schemas/selectColor"
                    },
                    "description": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "type": "object"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "type": "object"
          },
          "type": {
            "const": "multi_select",
            "description": "Always `multi_select`",
            "type": "string"
          }
        },
        "required": [
          "multi_select"
        ],
        "title": "Multi Select",
        "type": "object"
      },
      "multiSelectPropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "contains": {
                    "$ref": "#/components/schemas/stringOrStringArray"
                  }
                },
                "required": [
                  "contains"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_contain": {
                    "$ref": "#/components/schemas/stringOrStringArray"
                  }
                },
                "required": [
                  "does_not_contain"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "multiSelectPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "multi_select": {
            "items": {
              "$ref": "#/components/schemas/partialSelectResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "multi_select",
            "type": "string"
          }
        },
        "required": [
          "type",
          "multi_select",
          "object",
          "id"
        ],
        "title": "Multi Select",
        "type": "object"
      },
      "multiSelectSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "multi_select": {
            "items": {
              "$ref": "#/components/schemas/partialSelectPropertyValueResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "multi_select",
            "description": "Always `multi_select`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "multi_select"
        ],
        "title": "Multi Select",
        "type": "object"
      },
      "nonTerminalAsyncTaskStatus": {
        "enum": [
          "queued",
          "running",
          "retrying"
        ],
        "type": "string"
      },
      "noticonColor": {
        "description": "One of: `gray`, `lightgray`, `brown`, `yellow`, `orange`, `green`, `blue`, `purple`, `pink`, `red`",
        "enum": [
          "gray",
          "lightgray",
          "brown",
          "yellow",
          "orange",
          "green",
          "blue",
          "purple",
          "pink",
          "red"
        ],
        "type": "string"
      },
      "noticonIconResponse": {
        "additionalProperties": true,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponsenoticonColor",
            "description": "The color variant of the icon. Valid values: gray, lightgray, brown, yellow, orange, green, blue, purple, pink, red."
          },
          "name": {
            "$ref": "#/components/schemas/CompatibleResponsenoticonName",
            "description": "The name of the Notion icon (e.g. pizza, meeting, home). See the Notion icon picker for valid names."
          }
        },
        "required": [
          "name",
          "color"
        ],
        "type": "object"
      },
      "noticonName": {
        "examples": [
          "pizza",
          "meeting",
          "home",
          "star",
          "robot"
        ],
        "type": "string"
      },
      "numberDatabasePropertyConfigResponse": {
        "properties": {
          "number": {
            "additionalProperties": true,
            "properties": {
              "format": {
                "$ref": "#/components/schemas/CompatibleResponsenumberFormat",
                "description": "The number format for the property."
              }
            },
            "required": [
              "format"
            ],
            "type": "object"
          },
          "type": {
            "const": "number",
            "description": "Always `number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberFormat": {
        "example": "number",
        "type": "string"
      },
      "numberFormulaPropertyResponse": {
        "properties": {
          "number": {
            "type": [
              "number",
              "null"
            ]
          },
          "type": {
            "const": "number",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberFormulaPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "number": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "number",
            "description": "Always `number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberGroupByConfigRequest": {
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "range_end": {
            "description": "End of the range for number grouping buckets.",
            "type": "integer"
          },
          "range_size": {
            "description": "Size of each bucket in number grouping.",
            "minimum": 1,
            "type": "integer"
          },
          "range_start": {
            "description": "Start of the range for number grouping buckets.",
            "type": "integer"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "number",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "numberGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "range_end": {
            "description": "End of the range for number grouping buckets.",
            "type": "integer"
          },
          "range_size": {
            "description": "Size of each bucket in number grouping.",
            "minimum": 1,
            "type": "integer"
          },
          "range_start": {
            "description": "Start of the range for number grouping buckets.",
            "type": "integer"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (ascending or descending only)."
          },
          "type": {
            "const": "number",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "numberPartialRollupValueResponse": {
        "properties": {
          "number": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "number",
            "description": "Always `number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberPropertyConfigurationRequest": {
        "properties": {
          "number": {
            "properties": {
              "format": {
                "$ref": "#/components/schemas/numberFormat"
              }
            },
            "type": "object"
          },
          "type": {
            "const": "number",
            "description": "Always `number`",
            "type": "string"
          }
        },
        "required": [
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberPropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "equals": {
                    "type": "number"
                  }
                },
                "required": [
                  "equals"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_equal": {
                    "type": "number"
                  }
                },
                "required": [
                  "does_not_equal"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "greater_than": {
                    "type": "number"
                  }
                },
                "required": [
                  "greater_than"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "less_than": {
                    "type": "number"
                  }
                },
                "required": [
                  "less_than"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "greater_than_or_equal_to": {
                    "type": "number"
                  }
                },
                "required": [
                  "greater_than_or_equal_to"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "less_than_or_equal_to": {
                    "type": "number"
                  }
                },
                "required": [
                  "less_than_or_equal_to"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "numberPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "number": {
            "type": [
              "number",
              "null"
            ]
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "number",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number",
          "object",
          "id"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "number": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "number",
            "description": "Always `number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "number"
        ],
        "title": "Number",
        "type": "object"
      },
      "numberedListFormat": {
        "enum": [
          "numbers",
          "letters",
          "roman"
        ],
        "type": "string"
      },
      "numberedListItemBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "numbered_list_item": {
            "$ref": "#/components/schemas/contentWithRichTextAndColorAndListResponse"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "numbered_list_item",
            "type": "string"
          }
        },
        "required": [
          "type",
          "numbered_list_item",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Numbered List Item",
        "type": "object"
      },
      "pageContentUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity whose content was updated."
                  },
                  "updated_blocks": {
                    "description": "The blocks that were updated in this event.",
                    "items": {
                      "$ref": "#/components/schemas/webhookUpdatedBlock"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "updated_blocks"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.content_updated",
                "description": "Always `page.content_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageCoverRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/fileUploadPageCoverRequest"
          },
          {
            "$ref": "#/components/schemas/externalPageCoverRequest"
          }
        ]
      },
      "pageCoverResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/filePageCoverResponse"
          },
          {
            "$ref": "#/components/schemas/externalPageCoverResponse"
          }
        ]
      },
      "pageCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.created",
                "description": "Always `page.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.deleted",
                "description": "Always `page.deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageIconRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/fileUploadPageIconRequest"
          },
          {
            "$ref": "#/components/schemas/emojiPageIconRequest"
          },
          {
            "$ref": "#/components/schemas/externalPageIconRequest"
          },
          {
            "$ref": "#/components/schemas/customEmojiPageIconRequest"
          },
          {
            "$ref": "#/components/schemas/iconPageIconRequest"
          }
        ]
      },
      "pageIconResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/emojiPageIconResponse"
          },
          {
            "$ref": "#/components/schemas/filePageIconResponse"
          },
          {
            "$ref": "#/components/schemas/externalPageIconResponse"
          },
          {
            "$ref": "#/components/schemas/customEmojiPageIconResponse"
          },
          {
            "$ref": "#/components/schemas/iconPageIconResponse"
          }
        ]
      },
      "pageIdCommentParentResponse": {
        "additionalProperties": true,
        "properties": {
          "page_id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "type": {
            "const": "page_id",
            "description": "Always `page_id`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "page_id"
        ],
        "title": "Page Id",
        "type": "object"
      },
      "pageIdParentForBlockBasedObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "page_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent page."
          },
          "type": {
            "const": "page_id",
            "description": "The parent type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "page_id"
        ],
        "type": "object"
      },
      "pageLockedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.locked",
                "description": "Always `page.locked`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageMarkdownResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the page or block."
          },
          "markdown": {
            "description": "The page content as Markdown, in the syntax set by `markdown_version`: Notion-flavored Markdown (`v2`, recommended) or enhanced markdown (`v1`, deprecated, the default on current Notion-Versions).",
            "type": "string"
          },
          "object": {
            "const": "page_markdown",
            "description": "The type of object, always 'page_markdown'.",
            "type": "string"
          },
          "truncated": {
            "description": "Whether the content was truncated due to exceeding the record count limit.",
            "type": "boolean"
          },
          "unknown_block_ids": {
            "description": "Block IDs that could not be loaded (appeared as <unknown> tags in the markdown). Pass these IDs back to this endpoint to fetch their content separately.",
            "items": {
              "$ref": "#/components/schemas/idResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "warnings": {
            "description": "Content warnings from a synchronous update. Returned only when there is at least one warning.",
            "items": {
              "additionalProperties": true,
              "properties": {
                "code": {
                  "description": "The warning category, for example `unsupported_tag` or `no_match`.",
                  "type": "string"
                },
                "message": {
                  "description": "What the request changed, ignored, or could not match.",
                  "type": "string"
                }
              },
              "required": [
                "code",
                "message"
              ],
              "type": "object"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "object",
          "id",
          "markdown",
          "truncated",
          "unknown_block_ids"
        ],
        "type": "object"
      },
      "pageMovedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.moved",
                "description": "Always `page.moved`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "cover": {
            "description": "Page cover image.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageCoverResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse",
            "description": "User who created the page."
          },
          "created_time": {
            "description": "Date and time when this page was created.",
            "format": "date-time",
            "type": "string"
          },
          "icon": {
            "description": "Page icon.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/pageIconResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the page."
          },
          "in_trash": {
            "description": "Whether the page is in trash.",
            "type": "boolean"
          },
          "is_archived": {
            "description": "Whether the page has been archived.",
            "type": "boolean"
          },
          "is_locked": {
            "description": "Whether the page is locked from editing in the Notion app UI.",
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse",
            "description": "User who last edited the page."
          },
          "last_edited_time": {
            "description": "Date and time when this page was last edited.",
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "page",
            "description": "The page object type name.",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse",
            "description": "Information about the page's parent."
          },
          "properties": {
            "additionalProperties": {
              "$ref": "#/components/schemas/pagePropertyValueWithIdResponse"
            },
            "description": "Property values of this page.",
            "type": "object"
          },
          "public_url": {
            "description": "The public URL of the Notion page, if it has been published to the web.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "description": "The URL of the Notion page.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "created_time",
          "last_edited_time",
          "in_trash",
          "is_archived",
          "is_locked",
          "url",
          "public_url",
          "parent",
          "properties",
          "icon",
          "cover",
          "created_by",
          "last_edited_by"
        ],
        "type": "object"
      },
      "pageOrDataSourceListResponse": {
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "object": {
            "const": "list",
            "type": "string"
          },
          "page_or_data_source": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "request_status": {
            "properties": {
              "incomplete_reason": {
                "enum": [
                  "query_result_limit_reached"
                ],
                "type": "string"
              },
              "type": {
                "enum": [
                  "complete",
                  "incomplete"
                ],
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          "results": {
            "items": {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/pageObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/partialPageObjectResponse"
                    }
                  ]
                },
                {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/partialDataSourceObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/dataSourceObjectResponse"
                    }
                  ]
                }
              ]
            },
            "type": "array"
          },
          "type": {
            "const": "page_or_data_source",
            "type": "string"
          }
        },
        "required": [
          "type",
          "page_or_data_source",
          "object",
          "next_cursor",
          "has_more",
          "results"
        ],
        "title": "Page Or Data Source",
        "type": "object"
      },
      "pagePositionSchema": {
        "anyOf": [
          {
            "properties": {
              "after_block": {
                "properties": {
                  "id": {
                    "$ref": "#/components/schemas/idRequest"
                  }
                },
                "required": [
                  "id"
                ],
                "type": "object"
              },
              "type": {
                "const": "after_block",
                "type": "string"
              }
            },
            "required": [
              "type",
              "after_block"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "page_start",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "page_end",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        ]
      },
      "pagePropertiesRequest": {
        "additionalProperties": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "title": {
                  "items": {
                    "$ref": "#/components/schemas/richTextItemRequest"
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "title",
                  "type": "string"
                }
              },
              "required": [
                "title"
              ],
              "title": "Title",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "rich_text": {
                  "items": {
                    "$ref": "#/components/schemas/richTextItemRequest"
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "rich_text",
                  "type": "string"
                }
              },
              "required": [
                "rich_text"
              ],
              "title": "Rich Text",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "number": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "type": {
                  "const": "number",
                  "type": "string"
                }
              },
              "required": [
                "number"
              ],
              "title": "Number",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "type": {
                  "const": "url",
                  "type": "string"
                },
                "url": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/textRequest"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "url"
              ],
              "title": "Url",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "select": {
                  "anyOf": [
                    {
                      "additionalProperties": false,
                      "properties": {
                        "color": {
                          "$ref": "#/components/schemas/selectColor"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/textRequest"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "id": {
                          "$ref": "#/components/schemas/stringRequest"
                        },
                        "name": {
                          "$ref": "#/components/schemas/textRequest"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": false,
                      "properties": {
                        "color": {
                          "$ref": "#/components/schemas/selectColor"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/textRequest"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "id": {
                          "$ref": "#/components/schemas/stringRequest"
                        },
                        "name": {
                          "$ref": "#/components/schemas/textRequest"
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "const": "select",
                  "type": "string"
                }
              },
              "required": [
                "select"
              ],
              "title": "Select",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "multi_select": {
                  "items": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "color": {
                            "$ref": "#/components/schemas/selectColor"
                          },
                          "description": {
                            "anyOf": [
                              {
                                "$ref": "#/components/schemas/textRequest"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "id": {
                            "$ref": "#/components/schemas/stringRequest"
                          },
                          "name": {
                            "$ref": "#/components/schemas/textRequest"
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "color": {
                            "$ref": "#/components/schemas/selectColor"
                          },
                          "description": {
                            "anyOf": [
                              {
                                "$ref": "#/components/schemas/textRequest"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "id": {
                            "$ref": "#/components/schemas/stringRequest"
                          },
                          "name": {
                            "$ref": "#/components/schemas/textRequest"
                          }
                        },
                        "required": [
                          "name"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "multi_select",
                  "type": "string"
                }
              },
              "required": [
                "multi_select"
              ],
              "title": "Multi Select",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "people": {
                  "items": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/partialUserObjectRequest"
                      },
                      {
                        "$ref": "#/components/schemas/groupObjectRequest"
                      }
                    ]
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "people",
                  "type": "string"
                }
              },
              "required": [
                "people"
              ],
              "title": "People",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "email": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/stringRequest"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "const": "email",
                  "type": "string"
                }
              },
              "required": [
                "email"
              ],
              "title": "Email",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "phone_number": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/stringRequest"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "const": "phone_number",
                  "type": "string"
                }
              },
              "required": [
                "phone_number"
              ],
              "title": "Phone Number",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "date": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/dateRequest"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "const": "date",
                  "type": "string"
                }
              },
              "required": [
                "date"
              ],
              "title": "Date",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "checkbox": {
                  "type": "boolean"
                },
                "type": {
                  "const": "checkbox",
                  "type": "string"
                }
              },
              "required": [
                "checkbox"
              ],
              "title": "Checkbox",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "relation": {
                  "items": {
                    "$ref": "#/components/schemas/relationItemPropertyValueResponse"
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "relation",
                  "type": "string"
                }
              },
              "required": [
                "relation"
              ],
              "title": "Relation",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "files": {
                  "items": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/internalOrExternalFileWithNameRequest"
                      },
                      {
                        "$ref": "#/components/schemas/fileUploadWithOptionalNameRequest"
                      }
                    ]
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "type": {
                  "const": "files",
                  "type": "string"
                }
              },
              "required": [
                "files"
              ],
              "title": "Files",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "status": {
                  "anyOf": [
                    {
                      "additionalProperties": false,
                      "properties": {
                        "color": {
                          "$ref": "#/components/schemas/selectColor"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/textRequest"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "id": {
                          "$ref": "#/components/schemas/stringRequest"
                        },
                        "name": {
                          "$ref": "#/components/schemas/textRequest"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": false,
                      "properties": {
                        "color": {
                          "$ref": "#/components/schemas/selectColor"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/textRequest"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "id": {
                          "$ref": "#/components/schemas/stringRequest"
                        },
                        "name": {
                          "$ref": "#/components/schemas/textRequest"
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "const": "status",
                  "type": "string"
                }
              },
              "required": [
                "status"
              ],
              "title": "Status",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "place": {
                  "properties": {
                    "address": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "aws_place_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "google_place_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "lat": {
                      "type": "number"
                    },
                    "lon": {
                      "type": "number"
                    },
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "lat",
                    "lon"
                  ],
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "type": {
                  "const": "place",
                  "type": "string"
                }
              },
              "required": [
                "place"
              ],
              "title": "Place",
              "type": "object"
            },
            {
              "additionalProperties": false,
              "properties": {
                "type": {
                  "const": "verification",
                  "type": "string"
                },
                "verification": {
                  "anyOf": [
                    {
                      "properties": {
                        "date": {
                          "$ref": "#/components/schemas/dateRequest"
                        },
                        "state": {
                          "const": "verified",
                          "type": "string"
                        }
                      },
                      "required": [
                        "state"
                      ],
                      "type": "object"
                    },
                    {
                      "properties": {
                        "state": {
                          "const": "unverified",
                          "type": "string"
                        }
                      },
                      "required": [
                        "state"
                      ],
                      "type": "object"
                    }
                  ]
                }
              },
              "required": [
                "verification"
              ],
              "title": "Verification",
              "type": "object"
            }
          ]
        },
        "type": "object"
      },
      "pagePropertiesUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the page whose properties were updated."
                  },
                  "updated_properties": {
                    "description": "The IDs of the properties that were updated.",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "updated_properties"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.properties_updated",
                "description": "Always `page.properties_updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pagePropertyValueWithIdResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/idObjectResponse"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/simpleOrArrayPropertyValueResponse"
              },
              {
                "$ref": "#/components/schemas/partialRollupPropertyResponse"
              }
            ]
          }
        ]
      },
      "pageReferenceResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The object ID."
          },
          "object": {
            "description": "The object type.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "pageTranscriptionBlockTranscriptDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "description": "Additional event-specific data.",
                "properties": {
                  "target": {
                    "$ref": "#/components/schemas/webhookExternalBlock",
                    "description": "The block that contained the deleted transcript."
                  },
                  "transcript_id": {
                    "description": "The ID of the deleted transcript, or `null` if not available.",
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "target",
                  "transcript_id"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.transcription_block.transcript_deleted",
                "description": "Always `page.transcription_block.transcript_deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageUndeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.undeleted",
                "description": "Always `page.undeleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageUnlockedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookPageEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "page.unlocked",
                "description": "Always `page.unlocked`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "pageWriteNotificationsSchema": {
        "description": "Controls the notifications Notion sends people about this change. Set mode to \"silent\" to skip page update notifications, @mention notifications, and notifications to people added to a Person property, or \"default\" to use the standard behavior. Database automations, reminders, and connection webhooks still work as usual. Page history, page activity, and workspace audit logs still record the change.",
        "properties": {
          "mode": {
            "enum": [
              "default",
              "silent"
            ],
            "type": "string"
          }
        },
        "required": [
          "mode"
        ],
        "type": "object"
      },
      "paragraphBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "paragraph": {
            "$ref": "#/components/schemas/contentWithRichTextColorAndIconResponse"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "paragraph",
            "type": "string"
          }
        },
        "required": [
          "type",
          "paragraph",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Paragraph",
        "type": "object"
      },
      "paragraphWithSingleLevelOfChildrenRequest": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/blockObjectRequestWithoutChildren"
            },
            "maxItems": 100,
            "type": "array"
          },
          "color": {
            "$ref": "#/components/schemas/apiColor"
          },
          "icon": {
            "$ref": "#/components/schemas/pageIconRequest"
          },
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "rich_text"
        ],
        "type": "object"
      },
      "parentForBlockBasedObjectResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/databaseParentResponse"
          },
          {
            "$ref": "#/components/schemas/dataSourceParentResponse"
          },
          {
            "$ref": "#/components/schemas/pageIdParentForBlockBasedObjectResponse"
          },
          {
            "$ref": "#/components/schemas/blockIdParentForBlockBasedObjectResponse"
          },
          {
            "$ref": "#/components/schemas/agentIdParentForBlockBasedObjectResponse"
          },
          {
            "$ref": "#/components/schemas/workspaceParentForBlockBasedObjectResponse"
          }
        ]
      },
      "parentOfDataSourceRequest": {
        "properties": {
          "database_id": {
            "$ref": "#/components/schemas/idRequest",
            "description": "The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105"
          },
          "type": {
            "const": "database_id",
            "description": "Always `database_id`",
            "type": "string"
          }
        },
        "required": [
          "database_id"
        ],
        "title": "Database Id",
        "type": "object"
      },
      "parentOfDataSourceResponse": {
        "description": "The parent of the data source. This is typically a database (`database_id`), but for externally synced data sources, can be another data source (`data_source_id`).",
        "oneOf": [
          {
            "$ref": "#/components/schemas/databaseParentResponse"
          },
          {
            "$ref": "#/components/schemas/dataSourceParentResponse"
          }
        ]
      },
      "parentOfDatabaseResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/pageIdParentForBlockBasedObjectResponse"
          },
          {
            "$ref": "#/components/schemas/workspaceParentForBlockBasedObjectResponse"
          },
          {
            "$ref": "#/components/schemas/databaseParentResponse"
          },
          {
            "$ref": "#/components/schemas/blockIdParentForBlockBasedObjectResponse"
          }
        ]
      },
      "partialBlockObjectResponse": {
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "partialCommentObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the comment."
          },
          "object": {
            "const": "comment",
            "description": "The comment object type name.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "partialDataSourceObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the data source."
          },
          "object": {
            "const": "data_source",
            "description": "The data source object type name.",
            "type": "string"
          },
          "properties": {
            "additionalProperties": {
              "$ref": "#/components/schemas/databasePropertyConfigResponse"
            },
            "description": "The properties schema of the data source.",
            "type": "object"
          }
        },
        "required": [
          "object",
          "id",
          "properties"
        ],
        "type": "object"
      },
      "partialDataSourceViewObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the view."
          },
          "object": {
            "const": "view",
            "description": "The object type name.",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/databaseParentResponse",
            "description": "The parent database of the view."
          },
          "type": {
            "description": "The view type.",
            "enum": [
              "table",
              "board",
              "list",
              "calendar",
              "timeline",
              "gallery",
              "form",
              "chart",
              "map",
              "dashboard"
            ],
            "type": "string"
          }
        },
        "required": [
          "object",
          "id",
          "parent",
          "type"
        ],
        "type": "object"
      },
      "partialDatabaseObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the database."
          },
          "object": {
            "const": "database",
            "description": "The database object type name.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "partialPageObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the page."
          },
          "object": {
            "const": "page",
            "description": "The page object type name.",
            "type": "string"
          }
        },
        "required": [
          "object",
          "id"
        ],
        "type": "object"
      },
      "partialRollupPropertyResponse": {
        "additionalProperties": true,
        "properties": {
          "rollup": {
            "$ref": "#/components/schemas/partialRollupValueResponse"
          },
          "type": {
            "const": "rollup",
            "description": "Always `rollup`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rollup"
        ],
        "type": "object"
      },
      "partialRollupValueResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/partialRollupValueResponseCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/numberPartialRollupValueResponse"
              },
              {
                "$ref": "#/components/schemas/datePartialRollupValueResponse"
              },
              {
                "$ref": "#/components/schemas/arrayPartialRollupValueResponse"
              },
              {
                "$ref": "#/components/schemas/unsupportedPartialRollupValueResponse"
              }
            ]
          }
        ]
      },
      "partialRollupValueResponseCommon": {
        "additionalProperties": true,
        "properties": {
          "function": {
            "$ref": "#/components/schemas/CompatibleResponserollupFunction",
            "description": "The function used for the rollup, e.g. count, count_values, percent_not_empty, max."
          }
        },
        "required": [
          "function"
        ],
        "type": "object"
      },
      "partialSelectPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "color": {
            "description": "One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`",
            "enum": [
              "default",
              "gray",
              "brown",
              "orange",
              "yellow",
              "green",
              "blue",
              "purple",
              "pink",
              "red"
            ],
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "color"
        ],
        "type": "object"
      },
      "partialSelectResponse": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseselectColor"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "color"
        ],
        "type": "object"
      },
      "partialUserObjectRequest": {
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idRequest",
            "description": "The ID of the user."
          },
          "object": {
            "const": "user",
            "description": "The user object type name.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "partialUserObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse"
          },
          "object": {
            "const": "user",
            "description": "Always `user`",
            "type": "string"
          }
        },
        "required": [
          "id",
          "object"
        ],
        "type": "object"
      },
      "pdfBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "pdf": {
            "$ref": "#/components/schemas/mediaContentWithFileAndCaptionResponse"
          },
          "type": {
            "const": "pdf",
            "type": "string"
          }
        },
        "required": [
          "type",
          "pdf",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Pdf",
        "type": "object"
      },
      "peopleArrayBasedPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "people": {
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/userValueResponse"
                },
                {
                  "$ref": "#/components/schemas/groupObjectResponse"
                }
              ]
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "people",
            "description": "Always `people`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "people"
        ],
        "title": "People",
        "type": "object"
      },
      "peopleDatabasePropertyConfigResponse": {
        "properties": {
          "people": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "people",
            "description": "Always `people`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "people"
        ],
        "title": "People",
        "type": "object"
      },
      "peoplePropertyConfigurationRequest": {
        "properties": {
          "people": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "people",
            "description": "Always `people`",
            "type": "string"
          }
        },
        "required": [
          "people"
        ],
        "title": "People",
        "type": "object"
      },
      "peoplePropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "contains": {
                    "$ref": "#/components/schemas/personIdOrMe"
                  }
                },
                "required": [
                  "contains"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_contain": {
                    "$ref": "#/components/schemas/personIdOrMe"
                  }
                },
                "required": [
                  "does_not_contain"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "peoplePropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "people": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/partialUserObjectResponse"
              },
              {
                "$ref": "#/components/schemas/userObjectResponse"
              }
            ]
          },
          "type": {
            "const": "people",
            "type": "string"
          }
        },
        "required": [
          "type",
          "people",
          "object",
          "id"
        ],
        "title": "People",
        "type": "object"
      },
      "personGroupByConfigRequest": {
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "person",
              "created_by",
              "last_edited_by"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "personGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups (only manual supported)."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "person",
              "created_by",
              "last_edited_by"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "personIdOrMe": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/idRequest"
          },
          {
            "const": "me",
            "type": "string"
          }
        ]
      },
      "personUserObjectResponse": {
        "properties": {
          "person": {
            "additionalProperties": true,
            "description": "Details about the person, when the `type` of the user is `person`.",
            "properties": {
              "email": {
                "description": "The email of the person.",
                "type": "string"
              },
              "email_verified": {
                "description": "Whether the person's email is verified.",
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "type": {
            "const": "person",
            "description": "Indicates this user is a person.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "person"
        ],
        "title": "Person",
        "type": "object"
      },
      "phoneNumberDatabasePropertyConfigResponse": {
        "properties": {
          "phone_number": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "phone_number",
            "description": "Always `phone_number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "phone_number"
        ],
        "title": "Phone Number",
        "type": "object"
      },
      "phoneNumberPropertyConfigurationRequest": {
        "properties": {
          "phone_number": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "phone_number",
            "description": "Always `phone_number`",
            "type": "string"
          }
        },
        "required": [
          "phone_number"
        ],
        "title": "Phone Number",
        "type": "object"
      },
      "phoneNumberPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "phone_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "const": "phone_number",
            "type": "string"
          }
        },
        "required": [
          "type",
          "phone_number",
          "object",
          "id"
        ],
        "title": "Phone Number",
        "type": "object"
      },
      "phoneNumberSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "phone_number": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "phone_number",
            "description": "Always `phone_number`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "phone_number"
        ],
        "title": "Phone Number",
        "type": "object"
      },
      "placeDatabasePropertyConfigResponse": {
        "properties": {
          "place": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "place",
            "description": "Always `place`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "place"
        ],
        "title": "Place",
        "type": "object"
      },
      "placePropertyConfigurationRequest": {
        "properties": {
          "place": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "place",
            "description": "Always `place`",
            "type": "string"
          }
        },
        "required": [
          "place"
        ],
        "title": "Place",
        "type": "object"
      },
      "placePropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "place": {
            "properties": {
              "address": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "aws_place_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "google_place_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "lat": {
                "type": "number"
              },
              "lon": {
                "type": "number"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "lat",
              "lon"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "type": {
            "const": "place",
            "type": "string"
          }
        },
        "required": [
          "type",
          "place",
          "object",
          "id"
        ],
        "title": "Place",
        "type": "object"
      },
      "placePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "address": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "aws_place_id": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "google_place_id": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "name": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "lat",
          "lon"
        ],
        "type": "object"
      },
      "placeSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "place": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/placePropertyValueResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "place",
            "description": "Always `place`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "place"
        ],
        "title": "Place",
        "type": "object"
      },
      "propertyConfigurationRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/propertyConfigurationRequestCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/numberPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/formulaPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/selectPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/multiSelectPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/statusPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/relationPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/rollupPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/uniqueIdPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/titlePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/richTextPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/urlPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/peoplePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/filesPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/emailPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/phoneNumberPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/datePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/checkboxPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/createdByPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/createdTimePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/lastEditedByPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/lastEditedTimePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/buttonPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/locationPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/verificationPropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/lastVisitedTimePropertyConfigurationRequest"
              },
              {
                "$ref": "#/components/schemas/placePropertyConfigurationRequest"
              }
            ]
          }
        ]
      },
      "propertyConfigurationRequestCommon": {
        "properties": {
          "description": {
            "description": "The description of the property.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/propertyDescriptionRequest"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "propertyDescriptionRequest": {
        "maxLength": 280,
        "minLength": 1,
        "type": "string"
      },
      "propertyFilter": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "title": {
                "$ref": "#/components/schemas/textPropertyFilter"
              },
              "type": {
                "const": "title",
                "type": "string"
              }
            },
            "required": [
              "title",
              "property"
            ],
            "title": "Title",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "rich_text": {
                "$ref": "#/components/schemas/textPropertyFilter"
              },
              "type": {
                "const": "rich_text",
                "type": "string"
              }
            },
            "required": [
              "rich_text",
              "property"
            ],
            "title": "Rich Text",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "number": {
                "$ref": "#/components/schemas/numberPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "number",
                "type": "string"
              }
            },
            "required": [
              "number",
              "property"
            ],
            "title": "Number",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "checkbox": {
                "$ref": "#/components/schemas/checkboxPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "checkbox",
                "type": "string"
              }
            },
            "required": [
              "checkbox",
              "property"
            ],
            "title": "Checkbox",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "select": {
                "$ref": "#/components/schemas/selectPropertyFilter"
              },
              "type": {
                "const": "select",
                "type": "string"
              }
            },
            "required": [
              "select",
              "property"
            ],
            "title": "Select",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "multi_select": {
                "$ref": "#/components/schemas/multiSelectPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "multi_select",
                "type": "string"
              }
            },
            "required": [
              "multi_select",
              "property"
            ],
            "title": "Multi Select",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "status": {
                "$ref": "#/components/schemas/statusPropertyFilter"
              },
              "type": {
                "const": "status",
                "type": "string"
              }
            },
            "required": [
              "status",
              "property"
            ],
            "title": "Status",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "date": {
                "$ref": "#/components/schemas/datePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "date",
                "type": "string"
              }
            },
            "required": [
              "date",
              "property"
            ],
            "title": "Date",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "people": {
                "$ref": "#/components/schemas/peoplePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "people",
                "type": "string"
              }
            },
            "required": [
              "people",
              "property"
            ],
            "title": "People",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "files": {
                "$ref": "#/components/schemas/existencePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "files",
                "type": "string"
              }
            },
            "required": [
              "files",
              "property"
            ],
            "title": "Files",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "type": {
                "const": "url",
                "type": "string"
              },
              "url": {
                "$ref": "#/components/schemas/textPropertyFilter"
              }
            },
            "required": [
              "url",
              "property"
            ],
            "title": "Url",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "email": {
                "$ref": "#/components/schemas/textPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "email",
                "type": "string"
              }
            },
            "required": [
              "email",
              "property"
            ],
            "title": "Email",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "phone_number": {
                "$ref": "#/components/schemas/textPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "phone_number",
                "type": "string"
              }
            },
            "required": [
              "phone_number",
              "property"
            ],
            "title": "Phone Number",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "relation": {
                "$ref": "#/components/schemas/relationPropertyFilter"
              },
              "type": {
                "const": "relation",
                "type": "string"
              }
            },
            "required": [
              "relation",
              "property"
            ],
            "title": "Relation",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "created_by": {
                "$ref": "#/components/schemas/peoplePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "created_by",
                "type": "string"
              }
            },
            "required": [
              "created_by",
              "property"
            ],
            "title": "Created By",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "created_time": {
                "$ref": "#/components/schemas/datePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "created_time",
                "type": "string"
              }
            },
            "required": [
              "created_time",
              "property"
            ],
            "title": "Created Time",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "last_edited_by": {
                "$ref": "#/components/schemas/peoplePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "last_edited_by",
                "type": "string"
              }
            },
            "required": [
              "last_edited_by",
              "property"
            ],
            "title": "Last Edited By",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "last_edited_time": {
                "$ref": "#/components/schemas/datePropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "last_edited_time",
                "type": "string"
              }
            },
            "required": [
              "last_edited_time",
              "property"
            ],
            "title": "Last Edited Time",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "formula": {
                "$ref": "#/components/schemas/formulaPropertyFilter"
              },
              "property": {
                "type": "string"
              },
              "type": {
                "const": "formula",
                "type": "string"
              }
            },
            "required": [
              "formula",
              "property"
            ],
            "title": "Formula",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "type": {
                "const": "unique_id",
                "type": "string"
              },
              "unique_id": {
                "$ref": "#/components/schemas/numberPropertyFilter"
              }
            },
            "required": [
              "unique_id",
              "property"
            ],
            "title": "Unique Id",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "rollup": {
                "$ref": "#/components/schemas/rollupPropertyFilter"
              },
              "type": {
                "const": "rollup",
                "type": "string"
              }
            },
            "required": [
              "rollup",
              "property"
            ],
            "title": "Rollup",
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "property": {
                "type": "string"
              },
              "type": {
                "const": "verification",
                "type": "string"
              },
              "verification": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/verificationPropertyStatusFilter"
                  },
                  {
                    "$ref": "#/components/schemas/verificationPropertyDoesNotEqualFilter"
                  }
                ]
              }
            },
            "required": [
              "verification",
              "property"
            ],
            "title": "Verification",
            "type": "object"
          }
        ]
      },
      "propertyItemListResponse": {
        "$ref": "#/components/schemas/propertyItemPropertyItemListResponse"
      },
      "propertyItemObjectResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/numberPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/urlPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/selectPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/multiSelectPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/statusPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/datePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/emailPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/phoneNumberPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/checkboxPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/filesPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/createdByPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/createdTimePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/lastEditedByPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/lastEditedTimePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/formulaPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/buttonPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/uniqueIdPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/verificationPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/placePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/titlePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/richTextPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/peoplePropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/relationPropertyItemObjectResponse"
          },
          {
            "$ref": "#/components/schemas/rollupPropertyItemObjectResponse"
          }
        ]
      },
      "propertyItemPropertyItemListResponse": {
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "object": {
            "const": "list",
            "type": "string"
          },
          "property_item": {
            "anyOf": [
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "next_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "title": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  "type": {
                    "const": "title",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "title",
                  "next_url",
                  "id"
                ],
                "title": "Title",
                "type": "object"
              },
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "next_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "rich_text": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  "type": {
                    "const": "rich_text",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "rich_text",
                  "next_url",
                  "id"
                ],
                "title": "Rich Text",
                "type": "object"
              },
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "next_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "people": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  "type": {
                    "const": "people",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "people",
                  "next_url",
                  "id"
                ],
                "title": "People",
                "type": "object"
              },
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "next_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "relation": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  "type": {
                    "const": "relation",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "relation",
                  "next_url",
                  "id"
                ],
                "title": "Relation",
                "type": "object"
              },
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "next_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "rollup": {
                    "anyOf": [
                      {
                        "properties": {
                          "function": {
                            "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                          },
                          "number": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "type": {
                            "const": "number",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "number",
                          "function"
                        ],
                        "title": "Number",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "date": {
                            "anyOf": [
                              {
                                "$ref": "#/components/schemas/dateResponse"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "function": {
                            "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                          },
                          "type": {
                            "const": "date",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "date",
                          "function"
                        ],
                        "title": "Date",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "array": {
                            "items": {
                              "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                            },
                            "maxItems": 100,
                            "type": "array"
                          },
                          "function": {
                            "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                          },
                          "type": {
                            "const": "array",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "array",
                          "function"
                        ],
                        "title": "Array",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "function": {
                            "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                          },
                          "type": {
                            "const": "unsupported",
                            "type": "string"
                          },
                          "unsupported": {
                            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                          }
                        },
                        "required": [
                          "type",
                          "unsupported",
                          "function"
                        ],
                        "title": "Unsupported",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "function": {
                            "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                          },
                          "incomplete": {
                            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                          },
                          "type": {
                            "const": "incomplete",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "incomplete",
                          "function"
                        ],
                        "title": "Incomplete",
                        "type": "object"
                      }
                    ]
                  },
                  "type": {
                    "const": "rollup",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "rollup",
                  "next_url",
                  "id"
                ],
                "title": "Rollup",
                "type": "object"
              }
            ]
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/propertyItemObjectResponse"
            },
            "type": "array"
          },
          "type": {
            "const": "property_item",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_item",
          "object",
          "next_cursor",
          "has_more",
          "results"
        ],
        "title": "Property Item",
        "type": "object"
      },
      "propertyOrTimestampFilter": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/propertyFilter"
          },
          {
            "$ref": "#/components/schemas/timestampFilter"
          }
        ]
      },
      "propertyOrTimestampFilterArray": {
        "items": {
          "$ref": "#/components/schemas/propertyOrTimestampFilter"
        },
        "maxItems": 100,
        "type": "array"
      },
      "propertySortResponse": {
        "additionalProperties": true,
        "properties": {
          "direction": {
            "description": "Sort direction.",
            "enum": [
              "ascending",
              "descending"
            ],
            "type": "string"
          },
          "property": {
            "description": "The name or ID of the property to sort by.",
            "type": "string"
          }
        },
        "required": [
          "property",
          "direction"
        ],
        "type": "object"
      },
      "publicApiAsyncTaskStatusResultJsonValue": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          },
          {
            "items": {
              "$ref": "#/components/schemas/publicApiAsyncTaskStatusResultJsonValue"
            },
            "type": "array"
          },
          {
            "additionalProperties": {
              "$ref": "#/components/schemas/publicApiAsyncTaskStatusResultJsonValue"
            },
            "type": "object"
          }
        ]
      },
      "publicApiCommonErrorResponse": {
        "properties": {
          "additional_data": {
            "additionalProperties": {
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              ]
            },
            "type": "object"
          },
          "message": {
            "type": "string"
          },
          "object": {
            "const": "error"
          }
        },
        "required": [
          "object",
          "message"
        ],
        "type": "object"
      },
      "quickFilterConditionRequest": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/emptyObject"
          },
          {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "title": {
                    "$ref": "#/components/schemas/textPropertyFilter"
                  },
                  "type": {
                    "const": "title",
                    "type": "string"
                  }
                },
                "required": [
                  "title"
                ],
                "title": "Title",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "rich_text": {
                    "$ref": "#/components/schemas/textPropertyFilter"
                  },
                  "type": {
                    "const": "rich_text",
                    "type": "string"
                  }
                },
                "required": [
                  "rich_text"
                ],
                "title": "Rich Text",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "number": {
                    "$ref": "#/components/schemas/numberPropertyFilter"
                  },
                  "type": {
                    "const": "number",
                    "type": "string"
                  }
                },
                "required": [
                  "number"
                ],
                "title": "Number",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "checkbox": {
                    "$ref": "#/components/schemas/checkboxPropertyFilter"
                  },
                  "type": {
                    "const": "checkbox",
                    "type": "string"
                  }
                },
                "required": [
                  "checkbox"
                ],
                "title": "Checkbox",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "select": {
                    "$ref": "#/components/schemas/selectPropertyFilter"
                  },
                  "type": {
                    "const": "select",
                    "type": "string"
                  }
                },
                "required": [
                  "select"
                ],
                "title": "Select",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "multi_select": {
                    "$ref": "#/components/schemas/multiSelectPropertyFilter"
                  },
                  "type": {
                    "const": "multi_select",
                    "type": "string"
                  }
                },
                "required": [
                  "multi_select"
                ],
                "title": "Multi Select",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "$ref": "#/components/schemas/statusPropertyFilter"
                  },
                  "type": {
                    "const": "status",
                    "type": "string"
                  }
                },
                "required": [
                  "status"
                ],
                "title": "Status",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "date": {
                    "$ref": "#/components/schemas/datePropertyFilter"
                  },
                  "type": {
                    "const": "date",
                    "type": "string"
                  }
                },
                "required": [
                  "date"
                ],
                "title": "Date",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "people": {
                    "$ref": "#/components/schemas/peoplePropertyFilter"
                  },
                  "type": {
                    "const": "people",
                    "type": "string"
                  }
                },
                "required": [
                  "people"
                ],
                "title": "People",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "files": {
                    "$ref": "#/components/schemas/existencePropertyFilter"
                  },
                  "type": {
                    "const": "files",
                    "type": "string"
                  }
                },
                "required": [
                  "files"
                ],
                "title": "Files",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "url",
                    "type": "string"
                  },
                  "url": {
                    "$ref": "#/components/schemas/textPropertyFilter"
                  }
                },
                "required": [
                  "url"
                ],
                "title": "Url",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "email": {
                    "$ref": "#/components/schemas/textPropertyFilter"
                  },
                  "type": {
                    "const": "email",
                    "type": "string"
                  }
                },
                "required": [
                  "email"
                ],
                "title": "Email",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "phone_number": {
                    "$ref": "#/components/schemas/textPropertyFilter"
                  },
                  "type": {
                    "const": "phone_number",
                    "type": "string"
                  }
                },
                "required": [
                  "phone_number"
                ],
                "title": "Phone Number",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "relation": {
                    "$ref": "#/components/schemas/relationPropertyFilter"
                  },
                  "type": {
                    "const": "relation",
                    "type": "string"
                  }
                },
                "required": [
                  "relation"
                ],
                "title": "Relation",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "created_by": {
                    "$ref": "#/components/schemas/peoplePropertyFilter"
                  },
                  "type": {
                    "const": "created_by",
                    "type": "string"
                  }
                },
                "required": [
                  "created_by"
                ],
                "title": "Created By",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "created_time": {
                    "$ref": "#/components/schemas/datePropertyFilter"
                  },
                  "type": {
                    "const": "created_time",
                    "type": "string"
                  }
                },
                "required": [
                  "created_time"
                ],
                "title": "Created Time",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "last_edited_by": {
                    "$ref": "#/components/schemas/peoplePropertyFilter"
                  },
                  "type": {
                    "const": "last_edited_by",
                    "type": "string"
                  }
                },
                "required": [
                  "last_edited_by"
                ],
                "title": "Last Edited By",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "last_edited_time": {
                    "$ref": "#/components/schemas/datePropertyFilter"
                  },
                  "type": {
                    "const": "last_edited_time",
                    "type": "string"
                  }
                },
                "required": [
                  "last_edited_time"
                ],
                "title": "Last Edited Time",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "formula": {
                    "$ref": "#/components/schemas/formulaPropertyFilter"
                  },
                  "type": {
                    "const": "formula",
                    "type": "string"
                  }
                },
                "required": [
                  "formula"
                ],
                "title": "Formula",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "unique_id",
                    "type": "string"
                  },
                  "unique_id": {
                    "$ref": "#/components/schemas/numberPropertyFilter"
                  }
                },
                "required": [
                  "unique_id"
                ],
                "title": "Unique Id",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "rollup": {
                    "$ref": "#/components/schemas/rollupPropertyFilter"
                  },
                  "type": {
                    "const": "rollup",
                    "type": "string"
                  }
                },
                "required": [
                  "rollup"
                ],
                "title": "Rollup",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "verification",
                    "type": "string"
                  },
                  "verification": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/verificationPropertyStatusFilter"
                      },
                      {
                        "$ref": "#/components/schemas/verificationPropertyDoesNotEqualFilter"
                      }
                    ]
                  }
                },
                "required": [
                  "verification"
                ],
                "title": "Verification",
                "type": "object"
              }
            ]
          }
        ],
        "description": "A property filter condition. The quick filter key identifies the property. Pass an empty object to add the property to the filter bar without criteria."
      },
      "quickFilterConditionResponse": {
        "description": "A property filter condition. Same shape as a property filter but without the \"property\" field. For example: { \"select\": { \"equals\": \"High\" } }. An empty object means the quick filter has no criteria yet.",
        "type": "object"
      },
      "quoteBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "quote": {
            "$ref": "#/components/schemas/contentWithRichTextAndColorResponse"
          },
          "type": {
            "const": "quote",
            "type": "string"
          }
        },
        "required": [
          "type",
          "quote",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Quote",
        "type": "object"
      },
      "relationArrayBasedPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "relation": {
            "items": {
              "$ref": "#/components/schemas/CompatibleResponserelationItemPropertyValueResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "relation",
            "description": "Always `relation`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "relation"
        ],
        "title": "Relation",
        "type": "object"
      },
      "relationDatabasePropertyConfigResponse": {
        "properties": {
          "relation": {
            "$ref": "#/components/schemas/databasePropertyRelationConfigResponse"
          },
          "type": {
            "const": "relation",
            "description": "Always `relation`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "relation"
        ],
        "title": "Relation",
        "type": "object"
      },
      "relationGroupByConfigRequest": {
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "relation",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "relationGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "relation",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "relationItemPropertyValueResponse": {
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idRequest"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "relationPropertyConfigurationRequest": {
        "properties": {
          "relation": {
            "allOf": [
              {
                "properties": {
                  "data_source_id": {
                    "$ref": "#/components/schemas/idRequest"
                  }
                },
                "required": [
                  "data_source_id"
                ],
                "type": "object"
              },
              {
                "oneOf": [
                  {
                    "properties": {
                      "single_property": {
                        "$ref": "#/components/schemas/emptyObject"
                      },
                      "type": {
                        "const": "single_property",
                        "description": "Always `single_property`",
                        "type": "string"
                      }
                    },
                    "required": [
                      "single_property"
                    ],
                    "title": "Single Property",
                    "type": "object"
                  },
                  {
                    "properties": {
                      "dual_property": {
                        "properties": {
                          "synced_property_id": {
                            "type": "string"
                          },
                          "synced_property_name": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": {
                        "const": "dual_property",
                        "description": "Always `dual_property`",
                        "type": "string"
                      }
                    },
                    "required": [
                      "dual_property"
                    ],
                    "title": "Dual Property",
                    "type": "object"
                  }
                ]
              }
            ]
          },
          "type": {
            "const": "relation",
            "description": "Always `relation`",
            "type": "string"
          }
        },
        "required": [
          "relation"
        ],
        "title": "Relation",
        "type": "object"
      },
      "relationPropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "contains": {
                    "$ref": "#/components/schemas/idRequest"
                  }
                },
                "required": [
                  "contains"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_contain": {
                    "$ref": "#/components/schemas/idRequest"
                  }
                },
                "required": [
                  "does_not_contain"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "relationPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "relation": {
            "properties": {
              "id": {
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "type": {
            "const": "relation",
            "type": "string"
          }
        },
        "required": [
          "type",
          "relation",
          "object",
          "id"
        ],
        "title": "Relation",
        "type": "object"
      },
      "relativeDateValue": {
        "enum": [
          "today",
          "tomorrow",
          "yesterday",
          "one_week_ago",
          "one_week_from_now",
          "one_month_ago",
          "one_month_from_now"
        ],
        "type": "string"
      },
      "requestStatusResponse": {
        "additionalProperties": true,
        "properties": {
          "incomplete_reason": {
            "const": "query_result_limit_reached",
            "description": "Why the result set is incomplete. Only present when `type` is `incomplete`.",
            "type": "string"
          },
          "type": {
            "description": "Whether the result set is complete or incomplete. `incomplete` means the response does not include all rows that match the query parameters (e.g. due to a server-side pagination depth limit).",
            "enum": [
              "complete",
              "incomplete"
            ],
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "richTextArrayBasedPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "rich_text": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "rich_text",
            "description": "Always `rich_text`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rich_text"
        ],
        "title": "Rich Text",
        "type": "object"
      },
      "richTextDatabasePropertyConfigResponse": {
        "properties": {
          "rich_text": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "rich_text",
            "description": "Always `rich_text`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rich_text"
        ],
        "title": "Rich Text",
        "type": "object"
      },
      "richTextItemRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/richTextItemRequestCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/textRichTextItemRequest"
              },
              {
                "$ref": "#/components/schemas/mentionRichTextItemRequest"
              },
              {
                "$ref": "#/components/schemas/equationRichTextItemRequest"
              }
            ]
          }
        ]
      },
      "richTextItemRequestCommon": {
        "properties": {
          "annotations": {
            "$ref": "#/components/schemas/annotationRequest",
            "description": "All rich text objects contain an annotations object that sets the styling for the rich text."
          }
        },
        "type": "object"
      },
      "richTextItemResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/richTextItemResponseCommon"
          },
          {
            "oneOf": [
              {
                "$ref": "#/components/schemas/textRichTextItemResponse"
              },
              {
                "$ref": "#/components/schemas/mentionRichTextItemResponse"
              },
              {
                "$ref": "#/components/schemas/equationRichTextItemResponse"
              }
            ]
          }
        ]
      },
      "richTextItemResponseCommon": {
        "additionalProperties": true,
        "properties": {
          "annotations": {
            "$ref": "#/components/schemas/annotationResponse",
            "description": "All rich text objects contain an annotations object that sets the styling for the rich text."
          },
          "href": {
            "description": "A URL that the rich text object links to or mentions.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "plain_text": {
            "description": "The plain text content of the rich text object, without any styling.",
            "type": "string"
          }
        },
        "required": [
          "plain_text",
          "href",
          "annotations"
        ],
        "type": "object"
      },
      "richTextPropertyConfigurationRequest": {
        "properties": {
          "rich_text": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "rich_text",
            "description": "Always `rich_text`",
            "type": "string"
          }
        },
        "required": [
          "rich_text"
        ],
        "title": "Rich Text",
        "type": "object"
      },
      "richTextPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "rich_text": {
            "$ref": "#/components/schemas/richTextItemResponse"
          },
          "type": {
            "const": "rich_text",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rich_text",
          "object",
          "id"
        ],
        "title": "Rich Text",
        "type": "object"
      },
      "rollupDatabasePropertyConfigResponse": {
        "properties": {
          "rollup": {
            "additionalProperties": true,
            "properties": {
              "function": {
                "$ref": "#/components/schemas/CompatibleResponserollupFunction",
                "description": "The function to use for the rollup, e.g. count, count_values, percent_not_empty, max."
              },
              "relation_property_id": {
                "type": "string"
              },
              "relation_property_name": {
                "type": "string"
              },
              "rollup_property_id": {
                "type": "string"
              },
              "rollup_property_name": {
                "type": "string"
              }
            },
            "required": [
              "function",
              "rollup_property_name",
              "relation_property_name",
              "rollup_property_id",
              "relation_property_id"
            ],
            "type": "object"
          },
          "type": {
            "const": "rollup",
            "description": "Always `rollup`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rollup"
        ],
        "title": "Rollup",
        "type": "object"
      },
      "rollupFunction": {
        "enum": [
          "count",
          "count_values",
          "empty",
          "not_empty",
          "unique",
          "show_unique",
          "percent_empty",
          "percent_not_empty",
          "sum",
          "average",
          "median",
          "min",
          "max",
          "range",
          "earliest_date",
          "latest_date",
          "date_range",
          "checked",
          "unchecked",
          "percent_checked",
          "percent_unchecked",
          "count_per_group",
          "percent_per_group",
          "show_original"
        ],
        "type": "string"
      },
      "rollupPropertyConfigurationRequest": {
        "properties": {
          "rollup": {
            "allOf": [
              {
                "properties": {
                  "function": {
                    "$ref": "#/components/schemas/rollupFunction",
                    "description": "The function to use for the rollup, e.g. count, count_values, percent_not_empty, max."
                  }
                },
                "required": [
                  "function"
                ],
                "type": "object"
              },
              {
                "oneOf": [
                  {
                    "properties": {
                      "relation_property_name": {
                        "type": "string"
                      },
                      "rollup_property_name": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "relation_property_name",
                      "rollup_property_name"
                    ],
                    "type": "object"
                  },
                  {
                    "properties": {
                      "relation_property_id": {
                        "type": "string"
                      },
                      "rollup_property_name": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "relation_property_id",
                      "rollup_property_name"
                    ],
                    "type": "object"
                  },
                  {
                    "properties": {
                      "relation_property_name": {
                        "type": "string"
                      },
                      "rollup_property_id": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "relation_property_name",
                      "rollup_property_id"
                    ],
                    "type": "object"
                  },
                  {
                    "properties": {
                      "relation_property_id": {
                        "type": "string"
                      },
                      "rollup_property_id": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "relation_property_id",
                      "rollup_property_id"
                    ],
                    "type": "object"
                  }
                ]
              }
            ]
          },
          "type": {
            "const": "rollup",
            "description": "Always `rollup`",
            "type": "string"
          }
        },
        "required": [
          "rollup"
        ],
        "title": "Rollup",
        "type": "object"
      },
      "rollupPropertyFilter": {
        "anyOf": [
          {
            "properties": {
              "any": {
                "$ref": "#/components/schemas/rollupSubfilterPropertyFilter"
              }
            },
            "required": [
              "any"
            ],
            "type": "object"
          },
          {
            "properties": {
              "none": {
                "$ref": "#/components/schemas/rollupSubfilterPropertyFilter"
              }
            },
            "required": [
              "none"
            ],
            "type": "object"
          },
          {
            "properties": {
              "every": {
                "$ref": "#/components/schemas/rollupSubfilterPropertyFilter"
              }
            },
            "required": [
              "every"
            ],
            "type": "object"
          },
          {
            "properties": {
              "date": {
                "$ref": "#/components/schemas/datePropertyFilter"
              }
            },
            "required": [
              "date"
            ],
            "type": "object"
          },
          {
            "properties": {
              "number": {
                "$ref": "#/components/schemas/numberPropertyFilter"
              }
            },
            "required": [
              "number"
            ],
            "type": "object"
          }
        ]
      },
      "rollupPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "rollup": {
            "anyOf": [
              {
                "properties": {
                  "function": {
                    "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                  },
                  "number": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "type": {
                    "const": "number",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "number",
                  "function"
                ],
                "title": "Number",
                "type": "object"
              },
              {
                "properties": {
                  "date": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/dateResponse"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "function": {
                    "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                  },
                  "type": {
                    "const": "date",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "date",
                  "function"
                ],
                "title": "Date",
                "type": "object"
              },
              {
                "properties": {
                  "array": {
                    "items": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "function": {
                    "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                  },
                  "type": {
                    "const": "array",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "array",
                  "function"
                ],
                "title": "Array",
                "type": "object"
              },
              {
                "properties": {
                  "function": {
                    "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                  },
                  "type": {
                    "const": "unsupported",
                    "type": "string"
                  },
                  "unsupported": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  }
                },
                "required": [
                  "type",
                  "unsupported",
                  "function"
                ],
                "title": "Unsupported",
                "type": "object"
              },
              {
                "properties": {
                  "function": {
                    "$ref": "#/components/schemas/CompatibleResponserollupFunction"
                  },
                  "incomplete": {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  "type": {
                    "const": "incomplete",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "incomplete",
                  "function"
                ],
                "title": "Incomplete",
                "type": "object"
              }
            ]
          },
          "type": {
            "const": "rollup",
            "type": "string"
          }
        },
        "required": [
          "type",
          "rollup",
          "object",
          "id"
        ],
        "title": "Rollup",
        "type": "object"
      },
      "rollupSubfilterPropertyFilter": {
        "anyOf": [
          {
            "properties": {
              "rich_text": {
                "$ref": "#/components/schemas/textPropertyFilter"
              }
            },
            "required": [
              "rich_text"
            ],
            "type": "object"
          },
          {
            "properties": {
              "number": {
                "$ref": "#/components/schemas/numberPropertyFilter"
              }
            },
            "required": [
              "number"
            ],
            "type": "object"
          },
          {
            "properties": {
              "checkbox": {
                "$ref": "#/components/schemas/checkboxPropertyFilter"
              }
            },
            "required": [
              "checkbox"
            ],
            "type": "object"
          },
          {
            "properties": {
              "select": {
                "$ref": "#/components/schemas/selectPropertyFilter"
              }
            },
            "required": [
              "select"
            ],
            "type": "object"
          },
          {
            "properties": {
              "multi_select": {
                "$ref": "#/components/schemas/multiSelectPropertyFilter"
              }
            },
            "required": [
              "multi_select"
            ],
            "type": "object"
          },
          {
            "properties": {
              "relation": {
                "$ref": "#/components/schemas/relationPropertyFilter"
              }
            },
            "required": [
              "relation"
            ],
            "type": "object"
          },
          {
            "properties": {
              "date": {
                "$ref": "#/components/schemas/datePropertyFilter"
              }
            },
            "required": [
              "date"
            ],
            "type": "object"
          },
          {
            "properties": {
              "people": {
                "$ref": "#/components/schemas/peoplePropertyFilter"
              }
            },
            "required": [
              "people"
            ],
            "type": "object"
          },
          {
            "properties": {
              "files": {
                "$ref": "#/components/schemas/existencePropertyFilter"
              }
            },
            "required": [
              "files"
            ],
            "type": "object"
          },
          {
            "properties": {
              "status": {
                "$ref": "#/components/schemas/statusPropertyFilter"
              }
            },
            "required": [
              "status"
            ],
            "type": "object"
          }
        ]
      },
      "selectColor": {
        "description": "One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`",
        "enum": [
          "default",
          "gray",
          "brown",
          "orange",
          "yellow",
          "green",
          "blue",
          "purple",
          "pink",
          "red"
        ],
        "type": "string"
      },
      "selectDatabasePropertyConfigResponse": {
        "properties": {
          "select": {
            "additionalProperties": true,
            "properties": {
              "options": {
                "items": {
                  "$ref": "#/components/schemas/selectPropertyResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "options"
            ],
            "type": "object"
          },
          "type": {
            "const": "select",
            "description": "Always `select`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "select"
        ],
        "title": "Select",
        "type": "object"
      },
      "selectGroupByConfigRequest": {
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "select",
              "multi_select"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "selectGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "select",
              "multi_select"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "sort"
        ],
        "type": "object"
      },
      "selectPropertyConfigurationRequest": {
        "properties": {
          "select": {
            "properties": {
              "options": {
                "items": {
                  "properties": {
                    "color": {
                      "$ref": "#/components/schemas/selectColor"
                    },
                    "description": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "type": "object"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "type": "object"
          },
          "type": {
            "const": "select",
            "description": "Always `select`",
            "type": "string"
          }
        },
        "required": [
          "select"
        ],
        "title": "Select",
        "type": "object"
      },
      "selectPropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "equals": {
                    "$ref": "#/components/schemas/stringOrStringArray"
                  }
                },
                "required": [
                  "equals"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_equal": {
                    "$ref": "#/components/schemas/stringOrStringArray"
                  }
                },
                "required": [
                  "does_not_equal"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "selectPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "select": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/partialSelectResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "select",
            "type": "string"
          }
        },
        "required": [
          "type",
          "select",
          "object",
          "id"
        ],
        "title": "Select",
        "type": "object"
      },
      "selectPropertyResponse": {
        "additionalProperties": true,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseselectColor"
          },
          "description": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "color",
          "description"
        ],
        "type": "object"
      },
      "selectSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "select": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/partialSelectPropertyValueResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "select",
            "description": "Always `select`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "select"
        ],
        "title": "Select",
        "type": "object"
      },
      "sessionAgentIdFilter": {
        "additionalProperties": false,
        "properties": {
          "property": {
            "description": "Filter sessions by agent_id.",
            "enum": [
              "agent_id"
            ],
            "type": "string"
          },
          "string": {
            "additionalProperties": false,
            "description": "An exact string comparison.",
            "properties": {
              "equals": {
                "description": "Return sessions with this exact value.",
                "type": "string"
              }
            },
            "required": [
              "equals"
            ],
            "type": "object"
          }
        },
        "required": [
          "property",
          "string"
        ],
        "type": "object"
      },
      "sessionIdFilter": {
        "additionalProperties": false,
        "properties": {
          "property": {
            "description": "Filter sessions by id.",
            "enum": [
              "id"
            ],
            "type": "string"
          },
          "string": {
            "additionalProperties": false,
            "description": "An exact string comparison.",
            "properties": {
              "equals": {
                "description": "Return sessions with this exact value.",
                "type": "string"
              }
            },
            "required": [
              "equals"
            ],
            "type": "object"
          }
        },
        "required": [
          "property",
          "string"
        ],
        "type": "object"
      },
      "sessionNestedFilter": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/sessionIdFilter"
          },
          {
            "$ref": "#/components/schemas/sessionAgentIdFilter"
          },
          {
            "$ref": "#/components/schemas/sessionStatusFilter"
          },
          {
            "$ref": "#/components/schemas/sessionTimestampFilter"
          },
          {
            "additionalProperties": false,
            "properties": {
              "and": {
                "description": "Return sessions that match every child filter.",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/sessionIdFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionAgentIdFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionStatusFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionTimestampFilter"
                    }
                  ]
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "and"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "or": {
                "description": "Return sessions that match any child filter.",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/sessionIdFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionAgentIdFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionStatusFilter"
                    },
                    {
                      "$ref": "#/components/schemas/sessionTimestampFilter"
                    }
                  ]
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "or"
            ],
            "type": "object"
          }
        ]
      },
      "sessionStatusFilter": {
        "additionalProperties": false,
        "properties": {
          "property": {
            "description": "Filter sessions by status.",
            "enum": [
              "status"
            ],
            "type": "string"
          },
          "status": {
            "additionalProperties": false,
            "description": "A session status comparison.",
            "properties": {
              "equals": {
                "description": "Return sessions with this status.",
                "enum": [
                  "queued",
                  "in_progress",
                  "requires_action",
                  "completed",
                  "failed",
                  "canceled",
                  "terminated"
                ],
                "type": "string"
              },
              "in": {
                "description": "Return sessions with any of these statuses.",
                "items": {
                  "enum": [
                    "queued",
                    "in_progress",
                    "requires_action",
                    "completed",
                    "failed",
                    "canceled",
                    "terminated"
                  ],
                  "type": "string"
                },
                "maxItems": 7,
                "type": "array"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "property",
          "status"
        ],
        "type": "object"
      },
      "sessionTimestampFilter": {
        "additionalProperties": false,
        "properties": {
          "property": {
            "description": "The session timestamp to compare.",
            "enum": [
              "created_at",
              "updated_at"
            ],
            "type": "string"
          },
          "timestamp": {
            "additionalProperties": false,
            "description": "A timestamp range.",
            "properties": {
              "after": {
                "description": "Return sessions after this time.",
                "format": "date-time",
                "type": "string"
              },
              "before": {
                "description": "Return sessions before this time.",
                "format": "date-time",
                "type": "string"
              },
              "on_or_after": {
                "description": "Return sessions at or after this time.",
                "format": "date-time",
                "type": "string"
              },
              "on_or_before": {
                "description": "Return sessions at or before this time.",
                "format": "date-time",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "property",
          "timestamp"
        ],
        "type": "object"
      },
      "simpleOrArrayPropertyValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/simplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/arrayBasedPropertyValueResponse"
          }
        ]
      },
      "simplePropertyValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/numberSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/urlSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/selectSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/multiSelectSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/statusSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/dateSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/emailSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/phoneNumberSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/checkboxSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/filesSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/createdBySimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/createdTimeSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/lastEditedBySimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/lastEditedTimeSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/formulaSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/buttonSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/uniqueIdSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/verificationSimplePropertyValueResponse"
          },
          {
            "$ref": "#/components/schemas/placeSimplePropertyValueResponse"
          }
        ]
      },
      "singlePropertyDatabasePropertyRelationConfigResponse": {
        "properties": {
          "single_property": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "single_property",
            "description": "Always `single_property`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "single_property"
        ],
        "title": "Single Property",
        "type": "object"
      },
      "sortDirectionRequest": {
        "description": "One of: `ascending`, `descending`",
        "enum": [
          "ascending",
          "descending"
        ],
        "type": "string"
      },
      "statusDatabasePropertyConfigResponse": {
        "properties": {
          "status": {
            "additionalProperties": true,
            "properties": {
              "default_option": {
                "description": "The name of the configured default status option, or null when no default is configured. Read-only.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "groups": {
                "description": "The groups for the status property.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "color": {
                      "$ref": "#/components/schemas/CompatibleResponseselectColor",
                      "description": "The color of the status group."
                    },
                    "id": {
                      "description": "The ID of the status group.",
                      "type": "string"
                    },
                    "name": {
                      "description": "The name of the status group.",
                      "type": "string"
                    },
                    "option_ids": {
                      "description": "The IDs of the status options in this group.",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "type": "array"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "color",
                    "option_ids"
                  ],
                  "type": "object"
                },
                "maxItems": 100,
                "type": "array"
              },
              "options": {
                "description": "The options for the status property.",
                "items": {
                  "$ref": "#/components/schemas/statusPropertyResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "default_option",
              "options",
              "groups"
            ],
            "type": "object"
          },
          "type": {
            "const": "status",
            "description": "Always `status`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "status"
        ],
        "title": "Status",
        "type": "object"
      },
      "statusGroupByConfigRequest": {
        "properties": {
          "group_by": {
            "description": "How to group status values. \"group\" groups by status group (To Do/In Progress/Done), \"option\" groups by individual option.",
            "enum": [
              "group",
              "option"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "status",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "statusGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "description": "How to group status values. \"group\" groups by status group (To Do/In Progress/Done), \"option\" groups by individual option.",
            "enum": [
              "group",
              "option"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "type": {
            "const": "status",
            "description": "The property type for grouping.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "statusGroupNames": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/stringRequest"
          },
          {
            "items": {
              "$ref": "#/components/schemas/stringRequest"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          }
        ]
      },
      "statusOptionGroup": {
        "description": "One of: `To-do`, `In progress`, `Complete`",
        "enum": [
          "To-do",
          "In progress",
          "Complete"
        ],
        "type": "string"
      },
      "statusOptionRequest": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/selectColor"
          },
          "description": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "group": {
            "$ref": "#/components/schemas/statusOptionGroup"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "statusOptionRequestArray": {
        "items": {
          "$ref": "#/components/schemas/statusOptionRequest"
        },
        "maxItems": 100,
        "type": "array"
      },
      "statusOptionUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/statusOptionUpdateRequestCommon"
          },
          {
            "oneOf": [
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "name"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ],
                "type": "object"
              }
            ]
          }
        ]
      },
      "statusOptionUpdateRequestArray": {
        "items": {
          "$ref": "#/components/schemas/statusOptionUpdateRequest"
        },
        "maxItems": 100,
        "type": "array"
      },
      "statusOptionUpdateRequestCommon": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/selectColor"
          },
          "description": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "group": {
            "$ref": "#/components/schemas/statusOptionGroup"
          }
        },
        "type": "object"
      },
      "statusPropertyConfigRequest": {
        "properties": {
          "options": {
            "$ref": "#/components/schemas/statusOptionRequestArray",
            "description": "The initial status options. If not provided, defaults are created."
          }
        },
        "type": "object"
      },
      "statusPropertyConfigUpdateRequest": {
        "properties": {
          "options": {
            "$ref": "#/components/schemas/statusOptionUpdateRequestArray",
            "description": "Status options to add or update. Use group to assign an option to To-do, In progress, or Complete. Existing options keep their current group when group is omitted; new options use To-do when present, or the first existing group otherwise."
          }
        },
        "type": "object"
      },
      "statusPropertyConfigurationRequest": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/statusPropertyConfigRequest"
          },
          "type": {
            "const": "status",
            "description": "Always `status`",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "Status",
        "type": "object"
      },
      "statusPropertyFilter": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/statusValueFilter"
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "statusPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/partialSelectResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "status",
            "type": "string"
          }
        },
        "required": [
          "type",
          "status",
          "object",
          "id"
        ],
        "title": "Status",
        "type": "object"
      },
      "statusPropertyResponse": {
        "additionalProperties": true,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/CompatibleResponseselectColor",
            "description": "The color of the status option."
          },
          "description": {
            "description": "The description of the status option.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "description": "The ID of the status option.",
            "type": "string"
          },
          "name": {
            "description": "The name of the status option.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "color",
          "description"
        ],
        "type": "object"
      },
      "statusSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "status": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/partialSelectPropertyValueResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "status",
            "description": "Always `status`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "status"
        ],
        "title": "Status",
        "type": "object"
      },
      "statusValueFilter": {
        "anyOf": [
          {
            "properties": {
              "equals": {
                "$ref": "#/components/schemas/stringOrStringArray"
              }
            },
            "required": [
              "equals"
            ],
            "type": "object"
          },
          {
            "properties": {
              "does_not_equal": {
                "$ref": "#/components/schemas/stringOrStringArray"
              }
            },
            "required": [
              "does_not_equal"
            ],
            "type": "object"
          },
          {
            "properties": {
              "group_equals": {
                "$ref": "#/components/schemas/statusGroupNames"
              }
            },
            "required": [
              "group_equals"
            ],
            "type": "object"
          },
          {
            "properties": {
              "group_does_not_equal": {
                "$ref": "#/components/schemas/statusGroupNames"
              }
            },
            "required": [
              "group_does_not_equal"
            ],
            "type": "object"
          }
        ],
        "description": "The group operators match status groups instead of options. They require the `Notion-Beta: status-group-filters-2026-10-06` header."
      },
      "stringFormulaPropertyResponse": {
        "properties": {
          "string": {
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "const": "string",
            "type": "string"
          }
        },
        "required": [
          "type",
          "string"
        ],
        "title": "String",
        "type": "object"
      },
      "stringFormulaPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "string": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "string",
            "description": "Always `string`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "string"
        ],
        "title": "String",
        "type": "object"
      },
      "stringOrStringArray": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "stringRequest": {
        "maxLength": 100,
        "minLength": 1,
        "type": "string"
      },
      "subtaskConfigRequest": {
        "properties": {
          "display_mode": {
            "description": "How sub-items are displayed. \"show\" renders hierarchically with toggles, \"hidden\" shows parents with a count, \"flattened\" shows sub-items with a parent indicator, \"disabled\" turns off sub-item rendering.",
            "enum": [
              "show",
              "hidden",
              "flattened",
              "disabled"
            ],
            "type": "string"
          },
          "filter_scope": {
            "description": "Which items are included when filtering. \"parents\" includes parent items only, \"parents_and_subitems\" includes both, \"subitems\" includes sub-items only.",
            "enum": [
              "parents",
              "parents_and_subitems",
              "subitems"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "Relation property ID used for parent-child nesting.",
            "type": "string"
          },
          "toggle_column_id": {
            "description": "Property ID of the column showing the sub-item expand/collapse toggle.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "subtaskConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "display_mode": {
            "description": "How sub-items are displayed. \"show\" renders hierarchically with toggles, \"hidden\" shows parents with a count, \"flattened\" shows sub-items with a parent indicator, \"disabled\" turns off sub-item rendering.",
            "enum": [
              "show",
              "hidden",
              "flattened",
              "disabled"
            ],
            "type": "string"
          },
          "filter_scope": {
            "description": "Which items are included when filtering. \"parents\" includes parent items only, \"parents_and_subitems\" includes both, \"subitems\" includes sub-items only.",
            "enum": [
              "parents",
              "parents_and_subitems",
              "subitems"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "Relation property ID used for parent-child nesting.",
            "type": "string"
          },
          "toggle_column_id": {
            "description": "Property ID of the column showing the sub-item expand/collapse toggle.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "syncedBlockBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "synced_block": {
            "properties": {
              "synced_from": {
                "properties": {
                  "block_id": {
                    "$ref": "#/components/schemas/CompatibleResponseidRequest"
                  },
                  "type": {
                    "const": "block_id",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "block_id"
                ],
                "title": "Block Id",
                "type": [
                  "object",
                  "null"
                ]
              }
            },
            "required": [
              "synced_from"
            ],
            "type": "object"
          },
          "type": {
            "const": "synced_block",
            "type": "string"
          }
        },
        "required": [
          "type",
          "synced_block",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Synced Block",
        "type": "object"
      },
      "tabBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "tab": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "tab",
            "type": "string"
          }
        },
        "required": [
          "type",
          "tab",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Tab",
        "type": "object"
      },
      "tabItemRequestWithSingleLevelOfChildren": {
        "additionalProperties": false,
        "properties": {
          "object": {
            "const": "block",
            "type": "string"
          },
          "paragraph": {
            "$ref": "#/components/schemas/paragraphWithSingleLevelOfChildrenRequest"
          },
          "type": {
            "const": "paragraph",
            "type": "string"
          }
        },
        "required": [
          "paragraph"
        ],
        "title": "Paragraph",
        "type": "object"
      },
      "tabItemRequestWithoutChildren": {
        "additionalProperties": false,
        "properties": {
          "object": {
            "const": "block",
            "type": "string"
          },
          "paragraph": {
            "$ref": "#/components/schemas/contentWithRichTextColorAndIconRequest"
          },
          "type": {
            "const": "paragraph",
            "type": "string"
          }
        },
        "required": [
          "paragraph"
        ],
        "title": "Paragraph",
        "type": "object"
      },
      "tabRequestWithNestedTabItemChildren": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/tabItemRequestWithSingleLevelOfChildren"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "children"
        ],
        "type": "object"
      },
      "tabRequestWithTabItemChildren": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/tabItemRequestWithoutChildren"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "children"
        ],
        "type": "object"
      },
      "tableBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "table": {
            "$ref": "#/components/schemas/contentWithTableResponse"
          },
          "type": {
            "const": "table",
            "type": "string"
          }
        },
        "required": [
          "type",
          "table",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Table",
        "type": "object"
      },
      "tableOfContentsBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "table_of_contents": {
            "properties": {
              "color": {
                "$ref": "#/components/schemas/CompatibleResponseapiColor"
              }
            },
            "required": [
              "color"
            ],
            "type": "object"
          },
          "type": {
            "const": "table_of_contents",
            "type": "string"
          }
        },
        "required": [
          "type",
          "table_of_contents",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Table Of Contents",
        "type": "object"
      },
      "tableRequestWithTableRowChildren": {
        "additionalProperties": false,
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/tableRowRequest"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          },
          "has_column_header": {
            "type": "boolean"
          },
          "has_row_header": {
            "type": "boolean"
          },
          "table_width": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "table_width",
          "children"
        ],
        "type": "object"
      },
      "tableRowBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "table_row": {
            "$ref": "#/components/schemas/contentWithTableRowResponse"
          },
          "type": {
            "const": "table_row",
            "type": "string"
          }
        },
        "required": [
          "type",
          "table_row",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Table Row",
        "type": "object"
      },
      "tableRowRequest": {
        "additionalProperties": false,
        "properties": {
          "object": {
            "const": "block",
            "type": "string"
          },
          "table_row": {
            "$ref": "#/components/schemas/contentWithTableRowRequest"
          },
          "type": {
            "const": "table_row",
            "type": "string"
          }
        },
        "required": [
          "table_row"
        ],
        "title": "Table Row",
        "type": "object"
      },
      "tableViewConfigRequest": {
        "properties": {
          "frozen_column_index": {
            "description": "Number of columns frozen from the left side of the table.",
            "minimum": 0,
            "type": "integer"
          },
          "group_by": {
            "description": "Group-by configuration for the table. Pass null to remove grouping.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/groupByConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "properties": {
            "description": "Property visibility and display configuration. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_vertical_lines": {
            "description": "Whether to show vertical grid lines between columns.",
            "type": "boolean"
          },
          "subtasks": {
            "description": "Subtask (sub-item) configuration. Pass null to reset subtask config to defaults (which may show subtasks). Use `{ \"display_mode\": \"disabled\" }` to explicitly disable subtasks.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/subtaskConfigRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "table",
            "description": "The view type. Must be \"table\".",
            "type": "string"
          },
          "wrap_cells": {
            "description": "Whether to wrap cell content in the table.",
            "type": "boolean"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "tableViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "frozen_column_index": {
            "description": "Index of the last frozen column. Columns up to and including this index are frozen.",
            "minimum": 0,
            "type": "integer"
          },
          "group_by": {
            "$ref": "#/components/schemas/groupByConfigResponse",
            "description": "Vertical (row) grouping configuration."
          },
          "properties": {
            "description": "Columns/properties visible in the table view.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "show_vertical_lines": {
            "description": "Whether to show vertical lines between columns.",
            "type": "boolean"
          },
          "subtasks": {
            "$ref": "#/components/schemas/subtaskConfigResponse",
            "description": "Sub-item (subtask) display configuration."
          },
          "type": {
            "const": "table",
            "description": "The view configuration type.",
            "type": "string"
          },
          "wrap_cells": {
            "description": "Whether to wrap cell content by default.",
            "type": "boolean"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "templateBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "template": {
            "properties": {
              "rich_text": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "rich_text"
            ],
            "type": "object"
          },
          "type": {
            "const": "template",
            "type": "string"
          }
        },
        "required": [
          "type",
          "template",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Template",
        "type": "object"
      },
      "templateMentionDateTemplateMentionRequest": {
        "additionalProperties": false,
        "properties": {
          "template_mention_date": {
            "description": "The date of the template mention.",
            "enum": [
              "today",
              "now"
            ],
            "type": "string"
          },
          "type": {
            "const": "template_mention_date",
            "description": "Always `template_mention_date`",
            "type": "string"
          }
        },
        "required": [
          "template_mention_date"
        ],
        "title": "Template Mention Date",
        "type": "object"
      },
      "templateMentionDateTemplateMentionResponse": {
        "additionalProperties": true,
        "properties": {
          "template_mention_date": {
            "description": "The date of the template mention.",
            "enum": [
              "today",
              "now"
            ],
            "type": "string"
          },
          "type": {
            "const": "template_mention_date",
            "description": "Always `template_mention_date`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "template_mention_date"
        ],
        "title": "Template Mention Date",
        "type": "object"
      },
      "templateMentionRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/templateMentionDateTemplateMentionRequest"
          },
          {
            "$ref": "#/components/schemas/templateMentionUserTemplateMentionRequest"
          }
        ]
      },
      "templateMentionResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/templateMentionDateTemplateMentionResponse"
          },
          {
            "$ref": "#/components/schemas/templateMentionUserTemplateMentionResponse"
          }
        ]
      },
      "templateMentionUserTemplateMentionRequest": {
        "additionalProperties": false,
        "properties": {
          "template_mention_user": {
            "const": "me",
            "description": "The user of the template mention.",
            "type": "string"
          },
          "type": {
            "const": "template_mention_user",
            "description": "Always `template_mention_user`",
            "type": "string"
          }
        },
        "required": [
          "template_mention_user"
        ],
        "title": "Template Mention User",
        "type": "object"
      },
      "templateMentionUserTemplateMentionResponse": {
        "additionalProperties": true,
        "properties": {
          "template_mention_user": {
            "const": "me",
            "description": "The user of the template mention.",
            "type": "string"
          },
          "type": {
            "const": "template_mention_user",
            "description": "Always `template_mention_user`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "template_mention_user"
        ],
        "title": "Template Mention User",
        "type": "object"
      },
      "templateTimezone": {
        "description": "IANA timezone to use when resolving template variables like @now and @today (e.g. 'America/New_York'). Defaults to the authorizing user's timezone for public integrations, or UTC for internal integrations.",
        "examples": [
          "America/New_York",
          "Europe/London",
          "Asia/Tokyo"
        ],
        "type": "string"
      },
      "textGroupByConfigRequest": {
        "properties": {
          "group_by": {
            "description": "How to group text values. \"exact\" = exact match, \"alphabet_prefix\" = first letter.",
            "enum": [
              "exact",
              "alphabet_prefix"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortRequest",
            "description": "Sort order for groups."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "text",
              "title",
              "url",
              "email",
              "phone_number"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "textGroupByConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "group_by": {
            "description": "How to group text values. \"exact\" = exact match, \"alphabet_prefix\" = first letter.",
            "enum": [
              "exact",
              "alphabet_prefix"
            ],
            "type": "string"
          },
          "hide_empty_groups": {
            "description": "Whether to hide groups that have no items.",
            "type": "boolean"
          },
          "property_id": {
            "description": "Property ID to group by.",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field).",
            "type": "string"
          },
          "sort": {
            "$ref": "#/components/schemas/groupSortResponse",
            "description": "Sort order for groups."
          },
          "type": {
            "description": "The property type for grouping.",
            "enum": [
              "text",
              "title",
              "url",
              "email",
              "phone_number"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "property_id",
          "group_by",
          "sort"
        ],
        "type": "object"
      },
      "textPropertyFilter": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "equals": {
                    "type": "string"
                  }
                },
                "required": [
                  "equals"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_equal": {
                    "type": "string"
                  }
                },
                "required": [
                  "does_not_equal"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "contains": {
                    "type": "string"
                  }
                },
                "required": [
                  "contains"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "does_not_contain": {
                    "type": "string"
                  }
                },
                "required": [
                  "does_not_contain"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "starts_with": {
                    "type": "string"
                  }
                },
                "required": [
                  "starts_with"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "ends_with": {
                    "type": "string"
                  }
                },
                "required": [
                  "ends_with"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/existencePropertyFilter"
          }
        ]
      },
      "textRequest": {
        "maxLength": 2000,
        "minLength": 1,
        "type": "string"
      },
      "textRichTextItemRequest": {
        "properties": {
          "text": {
            "additionalProperties": false,
            "description": "If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.",
            "properties": {
              "content": {
                "description": "The actual text content of the text.",
                "maxLength": 2000,
                "type": "string"
              },
              "link": {
                "description": "An object with information about any inline link in this text, if included.",
                "oneOf": [
                  {
                    "properties": {
                      "url": {
                        "description": "The URL of the link.",
                        "examples": [
                          "https://www.notion.com"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "content"
            ],
            "type": "object"
          },
          "type": {
            "const": "text",
            "description": "Always `text`",
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "title": "Text",
        "type": "object"
      },
      "textRichTextItemResponse": {
        "properties": {
          "text": {
            "additionalProperties": true,
            "description": "If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.",
            "properties": {
              "content": {
                "description": "The actual text content of the text.",
                "maxLength": 2000,
                "type": "string"
              },
              "link": {
                "description": "An object with information about any inline link in this text, if included.",
                "oneOf": [
                  {
                    "additionalProperties": true,
                    "properties": {
                      "url": {
                        "description": "The URL of the link.",
                        "examples": [
                          "https://www.notion.com"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "content",
              "link"
            ],
            "type": "object"
          },
          "type": {
            "const": "text",
            "description": "Always `text`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "text"
        ],
        "title": "Text",
        "type": "object"
      },
      "timeZoneRequest": {
        "example": "Africa/Abidjan",
        "type": "string"
      },
      "timelineArrowsByRequest": {
        "properties": {
          "property_id": {
            "description": "Relation property ID used for dependency arrows, or null to disable arrows.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "timelineArrowsByResponse": {
        "additionalProperties": true,
        "properties": {
          "property_id": {
            "description": "Relation property ID used for dependency arrows.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "timelinePreferenceRequest": {
        "properties": {
          "center_timestamp": {
            "description": "Timestamp (ms) to center the timeline view on.",
            "type": "integer"
          },
          "zoom_level": {
            "description": "Zoom level for the timeline.",
            "enum": [
              "hours",
              "day",
              "week",
              "bi_week",
              "month",
              "quarter",
              "year",
              "5_years"
            ],
            "type": "string"
          }
        },
        "required": [
          "zoom_level"
        ],
        "type": "object"
      },
      "timelinePreferenceResponse": {
        "additionalProperties": true,
        "properties": {
          "center_timestamp": {
            "description": "Center timestamp for the timeline view (Unix timestamp in ms).",
            "minimum": 0,
            "type": "integer"
          },
          "zoom_level": {
            "description": "Zoom level for the timeline.",
            "enum": [
              "hours",
              "day",
              "week",
              "bi_week",
              "month",
              "quarter",
              "year",
              "5_years"
            ],
            "type": "string"
          }
        },
        "required": [
          "zoom_level"
        ],
        "type": "object"
      },
      "timelineViewConfigRequest": {
        "properties": {
          "arrows_by": {
            "description": "Configuration for dependency arrows between timeline items. Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/timelineArrowsByRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "color_by": {
            "description": "Whether to color timeline items by a property. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "date_property_id": {
            "description": "Property ID of the date property used for the start of timeline items.",
            "type": "string"
          },
          "end_date_property_id": {
            "description": "Property ID of the date property used for the end of timeline items. Pass null to clear.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "preference": {
            "description": "Timeline display preferences (zoom level and center position). Pass null to clear.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/timelinePreferenceRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "properties": {
            "description": "Property visibility and display configuration on timeline items. Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_table": {
            "description": "Whether to show the table panel alongside the timeline. Pass null to clear.",
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "table_properties": {
            "description": "Property configuration for the table panel (when show_table is true). Pass null to clear.",
            "oneOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/viewPropertyConfigRequest"
                },
                "maxItems": 100,
                "type": "array"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "const": "timeline",
            "description": "The view type. Must be \"timeline\".",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date_property_id"
        ],
        "type": "object"
      },
      "timelineViewConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "arrows_by": {
            "$ref": "#/components/schemas/timelineArrowsByResponse",
            "description": "Dependency arrows configuration."
          },
          "color_by": {
            "description": "Whether to color-code items by property.",
            "type": "boolean"
          },
          "date_property_id": {
            "description": "Start date property - required.",
            "type": "string"
          },
          "date_property_name": {
            "description": "Start date property name (convenience field).",
            "type": "string"
          },
          "end_date_property_id": {
            "description": "End date property (optional, for items that span a range).",
            "type": "string"
          },
          "end_date_property_name": {
            "description": "End date property name (convenience field).",
            "type": "string"
          },
          "preference": {
            "$ref": "#/components/schemas/timelinePreferenceResponse",
            "description": "Timeline zoom/preference state."
          },
          "properties": {
            "description": "Properties to display on timeline items.",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "show_table": {
            "description": "Whether to show the table panel alongside the timeline.",
            "type": "boolean"
          },
          "table_properties": {
            "description": "Properties to display in the table panel (when show_table is true).",
            "items": {
              "$ref": "#/components/schemas/viewPropertyConfigResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "timeline",
            "description": "The view configuration type.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "date_property_id"
        ],
        "type": "object"
      },
      "timestampCreatedTimeFilter": {
        "additionalProperties": false,
        "properties": {
          "created_time": {
            "$ref": "#/components/schemas/datePropertyFilter"
          },
          "timestamp": {
            "const": "created_time",
            "type": "string"
          },
          "type": {
            "const": "created_time",
            "type": "string"
          }
        },
        "required": [
          "created_time",
          "timestamp"
        ],
        "title": "Created Time",
        "type": "object"
      },
      "timestampFilter": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/timestampCreatedTimeFilter"
          },
          {
            "$ref": "#/components/schemas/timestampLastEditedTimeFilter"
          }
        ]
      },
      "timestampLastEditedTimeFilter": {
        "additionalProperties": false,
        "properties": {
          "last_edited_time": {
            "$ref": "#/components/schemas/datePropertyFilter"
          },
          "timestamp": {
            "const": "last_edited_time",
            "type": "string"
          },
          "type": {
            "const": "last_edited_time",
            "type": "string"
          }
        },
        "required": [
          "last_edited_time",
          "timestamp"
        ],
        "title": "Last Edited Time",
        "type": "object"
      },
      "timestampSortResponse": {
        "additionalProperties": true,
        "properties": {
          "direction": {
            "description": "Sort direction.",
            "enum": [
              "ascending",
              "descending"
            ],
            "type": "string"
          },
          "timestamp": {
            "description": "The timestamp to sort by.",
            "enum": [
              "created_time",
              "last_edited_time"
            ],
            "type": "string"
          }
        },
        "required": [
          "timestamp",
          "direction"
        ],
        "type": "object"
      },
      "titleArrayBasedPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "title": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "type": {
            "const": "title",
            "description": "Always `title`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "title"
        ],
        "title": "Title",
        "type": "object"
      },
      "titleDatabasePropertyConfigResponse": {
        "properties": {
          "title": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          },
          "type": {
            "const": "title",
            "description": "Always `title`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "title"
        ],
        "title": "Title",
        "type": "object"
      },
      "titleObjectResponse": {
        "properties": {
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "titlePropertyConfigurationRequest": {
        "properties": {
          "title": {
            "$ref": "#/components/schemas/emptyObject"
          },
          "type": {
            "const": "title",
            "description": "Always `title`",
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "title": "Title",
        "type": "object"
      },
      "titlePropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "title": {
            "$ref": "#/components/schemas/richTextItemResponse"
          },
          "type": {
            "const": "title",
            "type": "string"
          }
        },
        "required": [
          "type",
          "title",
          "object",
          "id"
        ],
        "title": "Title",
        "type": "object"
      },
      "toDoBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "to_do": {
            "properties": {
              "checked": {
                "type": "boolean"
              },
              "color": {
                "$ref": "#/components/schemas/CompatibleResponseapiColor"
              },
              "rich_text": {
                "items": {
                  "$ref": "#/components/schemas/richTextItemResponse"
                },
                "maxItems": 100,
                "type": "array"
              }
            },
            "required": [
              "rich_text",
              "color",
              "checked"
            ],
            "type": "object"
          },
          "type": {
            "const": "to_do",
            "type": "string"
          }
        },
        "required": [
          "type",
          "to_do",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "To Do",
        "type": "object"
      },
      "toggleBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "toggle": {
            "$ref": "#/components/schemas/contentWithRichTextAndColorResponse"
          },
          "type": {
            "const": "toggle",
            "type": "string"
          }
        },
        "required": [
          "type",
          "toggle",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Toggle",
        "type": "object"
      },
      "transcriptionBlockResponse": {
        "properties": {
          "calendar_event": {
            "$ref": "#/components/schemas/transcriptionCalendarEventResponse"
          },
          "children": {
            "$ref": "#/components/schemas/transcriptionChildrenResponse"
          },
          "is_full_page": {
            "type": "boolean"
          },
          "recording": {
            "$ref": "#/components/schemas/transcriptionRecordingResponse"
          },
          "status": {
            "$ref": "#/components/schemas/apiTranscriptionStatus"
          },
          "title": {
            "items": {
              "$ref": "#/components/schemas/richTextItemResponse"
            },
            "maxItems": 100,
            "type": "array"
          }
        },
        "required": [
          "is_full_page"
        ],
        "type": "object"
      },
      "transcriptionCalendarEventResponse": {
        "properties": {
          "attendees": {
            "items": {
              "$ref": "#/components/schemas/CompatibleResponseidRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "end_time": {
            "format": "date-time",
            "type": "string"
          },
          "event_id": {
            "type": "string"
          },
          "start_time": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "start_time",
          "end_time"
        ],
        "type": "object"
      },
      "transcriptionChildrenResponse": {
        "properties": {
          "notes_block_id": {
            "$ref": "#/components/schemas/CompatibleResponseidRequest"
          },
          "summary_block_id": {
            "$ref": "#/components/schemas/CompatibleResponseidRequest"
          },
          "transcript_block_id": {
            "$ref": "#/components/schemas/CompatibleResponseidRequest"
          }
        },
        "type": "object"
      },
      "transcriptionRecordingResponse": {
        "properties": {
          "end_time": {
            "format": "date-time",
            "type": "string"
          },
          "start_time": {
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "uniqueIdDatabasePropertyConfigResponse": {
        "properties": {
          "type": {
            "const": "unique_id",
            "description": "Always `unique_id`",
            "type": "string"
          },
          "unique_id": {
            "additionalProperties": true,
            "properties": {
              "prefix": {
                "description": "The prefix for the unique ID.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "prefix"
            ],
            "type": "object"
          }
        },
        "required": [
          "type",
          "unique_id"
        ],
        "title": "Unique Id",
        "type": "object"
      },
      "uniqueIdPropertyConfigurationRequest": {
        "properties": {
          "type": {
            "const": "unique_id",
            "description": "Always `unique_id`",
            "type": "string"
          },
          "unique_id": {
            "properties": {
              "prefix": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "type": "object"
          }
        },
        "required": [
          "unique_id"
        ],
        "title": "Unique Id",
        "type": "object"
      },
      "uniqueIdPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "unique_id",
            "type": "string"
          },
          "unique_id": {
            "properties": {
              "number": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "prefix": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "prefix",
              "number"
            ],
            "type": "object"
          }
        },
        "required": [
          "type",
          "unique_id",
          "object",
          "id"
        ],
        "title": "Unique Id",
        "type": "object"
      },
      "uniqueIdPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "number": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "prefix": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "prefix",
          "number"
        ],
        "type": "object"
      },
      "uniqueIdSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "const": "unique_id",
            "description": "Always `unique_id`",
            "type": "string"
          },
          "unique_id": {
            "$ref": "#/components/schemas/uniqueIdPropertyValueResponse"
          }
        },
        "required": [
          "type",
          "unique_id"
        ],
        "title": "Unique Id",
        "type": "object"
      },
      "unsupportedBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "unsupported",
            "type": "string"
          },
          "unsupported": {
            "properties": {
              "block_type": {
                "description": "The underlying block type that is not currently supported by the Public API. Example values include: form, button, drive.",
                "type": "string"
              }
            },
            "required": [
              "block_type"
            ],
            "type": "object"
          }
        },
        "required": [
          "type",
          "unsupported",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Unsupported",
        "type": "object"
      },
      "unsupportedFormulaPropertyResponse": {
        "properties": {
          "type": {
            "const": "unsupported",
            "type": "string"
          },
          "unsupported": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          }
        },
        "required": [
          "type",
          "unsupported"
        ],
        "title": "Unsupported",
        "type": "object"
      },
      "unsupportedFormulaPropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "const": "unsupported",
            "description": "Always `unsupported`",
            "type": "string"
          },
          "unsupported": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          }
        },
        "required": [
          "type",
          "unsupported"
        ],
        "title": "Unsupported",
        "type": "object"
      },
      "unsupportedPartialRollupValueResponse": {
        "properties": {
          "type": {
            "const": "unsupported",
            "description": "Always `unsupported`",
            "type": "string"
          },
          "unsupported": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          }
        },
        "required": [
          "type",
          "unsupported"
        ],
        "title": "Unsupported",
        "type": "object"
      },
      "updateEmbedFileUploadRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "file_upload": {
            "$ref": "#/components/schemas/fileUploadIdRequest"
          }
        },
        "required": [
          "file_upload"
        ],
        "type": "object"
      },
      "updateMediaContentWithFileAndCaptionRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "external": {
            "$ref": "#/components/schemas/externalFileRequest"
          },
          "file_upload": {
            "$ref": "#/components/schemas/fileUploadIdRequest"
          }
        },
        "type": "object"
      },
      "updateMediaContentWithFileNameAndCaptionRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "external": {
            "$ref": "#/components/schemas/externalFileRequest"
          },
          "file_upload": {
            "$ref": "#/components/schemas/fileUploadIdRequest"
          },
          "name": {
            "$ref": "#/components/schemas/stringRequest"
          }
        },
        "type": "object"
      },
      "updateMediaContentWithUrlAndCaptionRequest": {
        "additionalProperties": false,
        "properties": {
          "caption": {
            "items": {
              "$ref": "#/components/schemas/richTextItemRequest"
            },
            "maxItems": 100,
            "type": "array"
          },
          "url": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "updateViewRequest": {
        "properties": {
          "configuration": {
            "$ref": "#/components/schemas/viewConfigRequest",
            "description": "View presentation configuration. The type field must match the view type. Individual nullable fields within the configuration can be set to null to clear them."
          },
          "filter": {
            "description": "Filter to apply to the view. Uses the same format as the data source query filter. Pass null to clear the filter.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/viewFilterRequest"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "description": "New name for the view.",
            "type": "string"
          },
          "quick_filters": {
            "description": "Quick filters for the view's filter bar. Keys are property names or IDs. Set a key to a filter condition to add/update that quick filter. Set a key to null to remove it. Pass null for the entire field to clear all quick filters. Unmentioned quick filters are preserved.",
            "oneOf": [
              {
                "additionalProperties": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/quickFilterConditionRequest"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "sorts": {
            "description": "Property sorts to apply to the view. Only property-based sorts are supported. Pass null to clear the sorts.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/viewPropertySortsRequest"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "urlDatabasePropertyConfigResponse": {
        "properties": {
          "type": {
            "const": "url",
            "description": "Always `url`",
            "type": "string"
          },
          "url": {
            "$ref": "#/components/schemas/CompatibleResponseemptyObject"
          }
        },
        "required": [
          "type",
          "url"
        ],
        "title": "Url",
        "type": "object"
      },
      "urlPropertyConfigurationRequest": {
        "properties": {
          "type": {
            "const": "url",
            "description": "Always `url`",
            "type": "string"
          },
          "url": {
            "$ref": "#/components/schemas/emptyObject"
          }
        },
        "required": [
          "url"
        ],
        "title": "Url",
        "type": "object"
      },
      "urlPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "url",
            "type": "string"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "type",
          "url",
          "object",
          "id"
        ],
        "title": "Url",
        "type": "object"
      },
      "urlSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "const": "url",
            "description": "Always `url`",
            "type": "string"
          },
          "url": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "type",
          "url"
        ],
        "title": "Url",
        "type": "object"
      },
      "userObjectResponse": {
        "oneOf": [
          {
            "additionalProperties": true,
            "properties": {
              "agent_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot."
              },
              "avatar_url": {
                "description": "The avatar URL of the user.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The ID of the user."
              },
              "name": {
                "description": "The name of the user.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "object": {
                "const": "user",
                "description": "The user object type name.",
                "type": "string"
              },
              "person": {
                "additionalProperties": true,
                "description": "Details about the person, when the `type` of the user is `person`.",
                "properties": {
                  "email": {
                    "description": "The email of the person.",
                    "type": "string"
                  },
                  "email_verified": {
                    "description": "Whether the person's email is verified.",
                    "type": "boolean"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "person",
                "description": "Indicates this user is a person.",
                "type": "string"
              }
            },
            "required": [
              "avatar_url",
              "id",
              "name",
              "object",
              "person",
              "type"
            ],
            "type": "object"
          },
          {
            "additionalProperties": true,
            "properties": {
              "agent_id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot."
              },
              "avatar_url": {
                "description": "The avatar URL of the user.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bot": {
                "description": "Details about the bot, when the `type` of the user is `bot`.",
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                  },
                  {
                    "$ref": "#/components/schemas/botInfoResponse"
                  }
                ]
              },
              "id": {
                "$ref": "#/components/schemas/idResponse",
                "description": "The ID of the user."
              },
              "name": {
                "description": "The name of the user.",
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "object": {
                "const": "user",
                "description": "The user object type name.",
                "type": "string"
              },
              "type": {
                "const": "bot",
                "description": "Indicates this user is a bot.",
                "type": "string"
              }
            },
            "required": [
              "avatar_url",
              "bot",
              "id",
              "name",
              "object",
              "type"
            ],
            "type": "object"
          }
        ]
      },
      "userObjectResponseCommon": {
        "additionalProperties": false,
        "properties": {
          "agent_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot."
          },
          "avatar_url": {
            "description": "The avatar URL of the user.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the user."
          },
          "name": {
            "description": "The name of the user.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "object": {
            "const": "user",
            "description": "The user object type name.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "object",
          "name",
          "avatar_url"
        ],
        "type": "object"
      },
      "userValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          {
            "$ref": "#/components/schemas/userObjectResponse"
          }
        ]
      },
      "verificationPropertyConfigurationRequest": {
        "properties": {
          "type": {
            "const": "verification",
            "description": "Always `verification`",
            "type": "string"
          },
          "verification": {
            "$ref": "#/components/schemas/emptyObject"
          }
        },
        "required": [
          "verification"
        ],
        "title": "Verification",
        "type": "object"
      },
      "verificationPropertyDoesNotEqualFilter": {
        "additionalProperties": false,
        "properties": {
          "does_not_equal": {
            "enum": [
              "verified",
              "expired",
              "none"
            ],
            "type": "string"
          }
        },
        "required": [
          "does_not_equal"
        ],
        "type": "object"
      },
      "verificationPropertyItemObjectResponse": {
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "const": "property_item",
            "type": "string"
          },
          "type": {
            "const": "verification",
            "type": "string"
          },
          "verification": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/verificationPropertyValueResponse"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "type",
          "verification",
          "object",
          "id"
        ],
        "title": "Verification",
        "type": "object"
      },
      "verificationPropertyResponse": {
        "additionalProperties": true,
        "properties": {
          "date": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/dateResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "state": {
            "description": "One of: `verified`, `expired`",
            "enum": [
              "verified",
              "expired"
            ],
            "type": "string"
          },
          "verified_by": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/userValueResponse"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "state",
          "date",
          "verified_by"
        ],
        "title": "Verified",
        "type": "object"
      },
      "verificationPropertyStatusFilter": {
        "additionalProperties": false,
        "properties": {
          "status": {
            "enum": [
              "verified",
              "expired",
              "none"
            ],
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "verificationPropertyUnverifiedResponse": {
        "additionalProperties": true,
        "properties": {
          "date": {
            "type": "null"
          },
          "state": {
            "const": "unverified",
            "description": "Always `unverified`",
            "type": "string"
          },
          "verified_by": {
            "type": "null"
          }
        },
        "required": [
          "state",
          "date",
          "verified_by"
        ],
        "title": "Unverified",
        "type": "object"
      },
      "verificationPropertyValueResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/verificationPropertyUnverifiedResponse"
          },
          {
            "$ref": "#/components/schemas/verificationPropertyResponse"
          }
        ]
      },
      "verificationSimplePropertyValueResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "const": "verification",
            "description": "Always `verification`",
            "type": "string"
          },
          "verification": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/verificationPropertyValueResponse"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "type",
          "verification"
        ],
        "title": "Verification",
        "type": "object"
      },
      "videoBlockObjectResponse": {
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "created_time": {
            "format": "date-time",
            "type": "string"
          },
          "has_children": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "in_trash": {
            "type": "boolean"
          },
          "last_edited_by": {
            "$ref": "#/components/schemas/partialUserObjectResponse"
          },
          "last_edited_time": {
            "format": "date-time",
            "type": "string"
          },
          "object": {
            "const": "block",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/parentForBlockBasedObjectResponse"
          },
          "type": {
            "const": "video",
            "type": "string"
          },
          "video": {
            "$ref": "#/components/schemas/mediaContentWithFileAndCaptionResponse"
          }
        },
        "required": [
          "type",
          "video",
          "parent",
          "object",
          "id",
          "created_time",
          "created_by",
          "last_edited_time",
          "last_edited_by",
          "has_children",
          "in_trash"
        ],
        "title": "Video",
        "type": "object"
      },
      "viewConfigRequest": {
        "description": "View configuration, discriminated by the type field.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/tableViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/boardViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/calendarViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/timelineViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/galleryViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/listViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/mapViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/formViewConfigRequest"
          },
          {
            "$ref": "#/components/schemas/chartViewConfigRequest"
          }
        ]
      },
      "viewConfigResponse": {
        "description": "View configuration, typed by view type (table, board, calendar, etc.).",
        "oneOf": [
          {
            "$ref": "#/components/schemas/tableViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/boardViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/calendarViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/timelineViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/galleryViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/listViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/mapViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/formViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/chartViewConfigResponse"
          },
          {
            "$ref": "#/components/schemas/dashboardViewConfigResponse"
          }
        ]
      },
      "viewCreatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the created view."
                  },
                  "view_type": {
                    "description": "The type of the created view (e.g. `table`, `board`, `list`, `calendar`, `gallery`, `timeline`).",
                    "type": "string"
                  }
                },
                "required": [
                  "parent",
                  "view_type"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookViewEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "view.created",
                "description": "Always `view.created`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "viewDeletedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the entity that triggered the event."
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookViewEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "view.deleted",
                "description": "Always `view.deleted`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "viewFilterRequest": {
        "anyOf": [
          {
            "anyOf": [
              {
                "properties": {
                  "or": {
                    "$ref": "#/components/schemas/groupFilterOperatorArray"
                  }
                },
                "required": [
                  "or"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "and": {
                    "$ref": "#/components/schemas/groupFilterOperatorArray"
                  }
                },
                "required": [
                  "and"
                ],
                "type": "object"
              }
            ]
          },
          {
            "$ref": "#/components/schemas/propertyFilter"
          },
          {
            "$ref": "#/components/schemas/timestampFilter"
          }
        ],
        "description": "A property filter, timestamp filter, or compound and/or filter."
      },
      "viewFilterResponse": {
        "description": "Filter for the view. Can be a property filter (filter by property value), timestamp filter (filter by created_time or last_edited_time), or compound filter (combine filters with and/or logic). Compound filters support up to 2 levels of nesting.",
        "oneOf": [
          {
            "additionalProperties": true,
            "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
            "properties": {
              "property": {
                "description": "The name or ID of the property to filter on.",
                "type": "string"
              }
            },
            "required": [
              "property"
            ],
            "type": "object"
          },
          {
            "additionalProperties": true,
            "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
            "properties": {
              "timestamp": {
                "description": "The timestamp to filter on.",
                "enum": [
                  "created_time",
                  "last_edited_time"
                ],
                "type": "string"
              }
            },
            "required": [
              "timestamp"
            ],
            "type": "object"
          },
          {
            "description": "A compound filter that combines multiple filters with AND or OR logic. Supports up to 2 levels of nesting.",
            "properties": {
              "and": {
                "description": "Filters combined with AND logic.",
                "items": {
                  "description": "A filter that can be a property filter, timestamp filter, or nested compound filter.",
                  "oneOf": [
                    {
                      "additionalProperties": true,
                      "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                      "properties": {
                        "property": {
                          "description": "The name or ID of the property to filter on.",
                          "type": "string"
                        }
                      },
                      "required": [
                        "property"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": true,
                      "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                      "properties": {
                        "timestamp": {
                          "description": "The timestamp to filter on.",
                          "enum": [
                            "created_time",
                            "last_edited_time"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "timestamp"
                      ],
                      "type": "object"
                    },
                    {
                      "description": "A compound filter at the deepest nesting level. Can only contain property or timestamp filters (no further nesting).",
                      "properties": {
                        "and": {
                          "description": "Filters combined with AND logic.",
                          "items": {
                            "description": "A property filter or timestamp filter.",
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                                "properties": {
                                  "property": {
                                    "description": "The name or ID of the property to filter on.",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "property"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                                "properties": {
                                  "timestamp": {
                                    "description": "The timestamp to filter on.",
                                    "enum": [
                                      "created_time",
                                      "last_edited_time"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "timestamp"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "type": "array"
                        },
                        "or": {
                          "description": "Filters combined with OR logic.",
                          "items": {
                            "description": "A property filter or timestamp filter.",
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                                "properties": {
                                  "property": {
                                    "description": "The name or ID of the property to filter on.",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "property"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                                "properties": {
                                  "timestamp": {
                                    "description": "The timestamp to filter on.",
                                    "enum": [
                                      "created_time",
                                      "last_edited_time"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "timestamp"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    }
                  ]
                },
                "type": "array"
              },
              "or": {
                "description": "Filters combined with OR logic.",
                "items": {
                  "description": "A filter that can be a property filter, timestamp filter, or nested compound filter.",
                  "oneOf": [
                    {
                      "additionalProperties": true,
                      "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                      "properties": {
                        "property": {
                          "description": "The name or ID of the property to filter on.",
                          "type": "string"
                        }
                      },
                      "required": [
                        "property"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": true,
                      "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                      "properties": {
                        "timestamp": {
                          "description": "The timestamp to filter on.",
                          "enum": [
                            "created_time",
                            "last_edited_time"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "timestamp"
                      ],
                      "type": "object"
                    },
                    {
                      "description": "A compound filter at the deepest nesting level. Can only contain property or timestamp filters (no further nesting).",
                      "properties": {
                        "and": {
                          "description": "Filters combined with AND logic.",
                          "items": {
                            "description": "A property filter or timestamp filter.",
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                                "properties": {
                                  "property": {
                                    "description": "The name or ID of the property to filter on.",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "property"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                                "properties": {
                                  "timestamp": {
                                    "description": "The timestamp to filter on.",
                                    "enum": [
                                      "created_time",
                                      "last_edited_time"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "timestamp"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "type": "array"
                        },
                        "or": {
                          "description": "Filters combined with OR logic.",
                          "items": {
                            "description": "A property filter or timestamp filter.",
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a specific property. The property field specifies which property to filter, and an additional field specifies the filter type and condition (e.g., title, rich_text, number, checkbox, select, multi_select, date, people, files, relation, formula, rollup, etc.).",
                                "properties": {
                                  "property": {
                                    "description": "The name or ID of the property to filter on.",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "property"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "description": "A filter condition on a timestamp (created_time or last_edited_time). The timestamp field specifies which timestamp, and a matching field contains the date filter condition.",
                                "properties": {
                                  "timestamp": {
                                    "description": "The timestamp to filter on.",
                                    "enum": [
                                      "created_time",
                                      "last_edited_time"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "timestamp"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    }
                  ]
                },
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "viewPositionRequest": {
        "description": "Position of the new view in the database's view tab bar.",
        "oneOf": [
          {
            "properties": {
              "type": {
                "const": "start",
                "description": "Position type. \"start\" places the view as the first tab.",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "end",
                "description": "Position type. \"end\" places the view as the last tab.",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "properties": {
              "type": {
                "const": "after_view",
                "description": "Position type. \"after_view\" places the new view immediately after the specified view.",
                "type": "string"
              },
              "view_id": {
                "$ref": "#/components/schemas/idRequest",
                "description": "The ID of an existing view in the database. The new view will be placed after this view."
              }
            },
            "required": [
              "type",
              "view_id"
            ],
            "type": "object"
          }
        ]
      },
      "viewPropertyConfigRequest": {
        "properties": {
          "card_property_width_mode": {
            "description": "Property width mode in compact card layouts (board/gallery).",
            "enum": [
              "full_line",
              "inline"
            ],
            "type": "string"
          },
          "date_format": {
            "description": "Date display format (date properties only).",
            "enum": [
              "full",
              "short",
              "month_day_year",
              "day_month_year",
              "year_month_day",
              "relative"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "Property ID (stable identifier).",
            "type": "string"
          },
          "status_show_as": {
            "description": "How to display status properties (select dropdown or checkbox).",
            "enum": [
              "select",
              "checkbox"
            ],
            "type": "string"
          },
          "time_format": {
            "description": "Time display format (date properties only).",
            "enum": [
              "12_hour",
              "24_hour",
              "hidden"
            ],
            "type": "string"
          },
          "visible": {
            "description": "Whether this property is visible in the view.",
            "type": "boolean"
          },
          "width": {
            "description": "Width of the property column in pixels (table view only).",
            "minimum": 1,
            "type": "integer"
          },
          "wrap": {
            "description": "Whether to wrap content in this property cell/card.",
            "type": "boolean"
          }
        },
        "required": [
          "property_id"
        ],
        "type": "object"
      },
      "viewPropertyConfigResponse": {
        "additionalProperties": true,
        "properties": {
          "card_property_width_mode": {
            "description": "Property width mode in compact card layouts (board/gallery).",
            "enum": [
              "full_line",
              "inline"
            ],
            "type": "string"
          },
          "date_format": {
            "description": "Date display format (date properties only). \"full\" = localized full date, \"short\" = month and day, \"month_day_year\" = MM/DD/YYYY, \"day_month_year\" = DD/MM/YYYY, \"year_month_day\" = YYYY/MM/DD, \"relative\" = relative dates.",
            "enum": [
              "full",
              "short",
              "month_day_year",
              "day_month_year",
              "year_month_day",
              "relative"
            ],
            "type": "string"
          },
          "property_id": {
            "description": "Property ID (stable identifier).",
            "type": "string"
          },
          "property_name": {
            "description": "Property name (convenience field, not stable across renames).",
            "type": "string"
          },
          "status_show_as": {
            "description": "How to display status properties (as select dropdown or checkbox).",
            "enum": [
              "select",
              "checkbox"
            ],
            "type": "string"
          },
          "time_format": {
            "description": "Time display format (date properties only). \"12_hour\" = 12-hour clock with AM/PM, \"24_hour\" = 24-hour clock, \"hidden\" = hide time.",
            "enum": [
              "12_hour",
              "24_hour",
              "hidden"
            ],
            "type": "string"
          },
          "visible": {
            "description": "Whether this property is visible in the view.",
            "type": "boolean"
          },
          "width": {
            "description": "Width of the property column in pixels (table view only).",
            "minimum": 0,
            "type": "integer"
          },
          "wrap": {
            "description": "Whether to wrap content in this property cell/card.",
            "type": "boolean"
          }
        },
        "required": [
          "property_id"
        ],
        "type": "object"
      },
      "viewPropertySortRequest": {
        "properties": {
          "direction": {
            "$ref": "#/components/schemas/sortDirectionRequest",
            "description": "Sort direction."
          },
          "property": {
            "description": "Property name or ID to sort by.",
            "type": "string"
          }
        },
        "required": [
          "property",
          "direction"
        ],
        "type": "object"
      },
      "viewPropertySortsRequest": {
        "items": {
          "$ref": "#/components/schemas/viewPropertySortRequest"
        },
        "maxItems": 100,
        "type": "array"
      },
      "viewQueryResponse": {
        "additionalProperties": true,
        "properties": {
          "expires_at": {
            "description": "When the cached query results expire.",
            "format": "date-time",
            "type": "string"
          },
          "has_more": {
            "description": "Whether there are more results.",
            "type": "boolean"
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The query ID."
          },
          "next_cursor": {
            "description": "Cursor for the next page of results.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/idResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "object": {
            "const": "view_query",
            "description": "The object type.",
            "type": "string"
          },
          "request_status": {
            "$ref": "#/components/schemas/requestStatusResponse",
            "description": "Set to `{ type: 'incomplete', incomplete_reason: 'query_result_limit_reached' }` when the view's underlying data source has more rows matching this query than the server-side pagination depth limit allows."
          },
          "results": {
            "description": "The page results for this page.",
            "items": {
              "$ref": "#/components/schemas/pageReferenceResponse"
            },
            "maxItems": 100,
            "type": "array"
          },
          "total_count": {
            "description": "Total number of results in the query.",
            "type": "number"
          },
          "view_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The view this query was executed against."
          }
        },
        "required": [
          "object",
          "id",
          "view_id",
          "expires_at",
          "total_count",
          "results",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "viewSortRequest": {
        "anyOf": [
          {
            "properties": {
              "direction": {
                "enum": [
                  "ascending",
                  "descending"
                ],
                "type": "string"
              },
              "property": {
                "type": "string"
              }
            },
            "required": [
              "property",
              "direction"
            ],
            "type": "object"
          },
          {
            "properties": {
              "direction": {
                "enum": [
                  "ascending",
                  "descending"
                ],
                "type": "string"
              },
              "timestamp": {
                "enum": [
                  "created_time",
                  "last_edited_time"
                ],
                "type": "string"
              }
            },
            "required": [
              "timestamp",
              "direction"
            ],
            "type": "object"
          }
        ],
        "description": "Sort by property name or ID, or by timestamp."
      },
      "viewSortResponse": {
        "description": "Sort for the view. Can sort by property or timestamp.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/propertySortResponse"
          },
          {
            "$ref": "#/components/schemas/timestampSortResponse"
          }
        ]
      },
      "viewSortsRequest": {
        "items": {
          "$ref": "#/components/schemas/viewSortRequest"
        },
        "maxItems": 100,
        "type": "array"
      },
      "viewTypeRequest": {
        "description": "One of: `table`, `board`, `list`, `calendar`, `timeline`, `gallery`, `form`, `chart`, `map`, `dashboard`",
        "enum": [
          "table",
          "board",
          "list",
          "calendar",
          "timeline",
          "gallery",
          "form",
          "chart",
          "map",
          "dashboard"
        ],
        "type": "string"
      },
      "viewUpdatedWebhookPayload": {
        "allOf": [
          {
            "$ref": "#/components/schemas/baseWebhookPayload"
          },
          {
            "properties": {
              "data": {
                "additionalProperties": false,
                "description": "Additional event-specific data.",
                "properties": {
                  "parent": {
                    "$ref": "#/components/schemas/webhookParentBlock",
                    "description": "The parent of the updated view."
                  },
                  "updated_fields": {
                    "description": "The fields of the view that were updated.",
                    "items": {
                      "description": "One of: `name`, `filter`, `sorts`, `configuration`",
                      "enum": [
                        "name",
                        "filter",
                        "sorts",
                        "configuration"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "updated_fields"
                ],
                "type": "object"
              },
              "entity": {
                "$ref": "#/components/schemas/webhookViewEntity",
                "description": "The object that triggered the event."
              },
              "type": {
                "const": "view.updated",
                "description": "Always `view.updated`",
                "type": "string"
              }
            },
            "required": [
              "type",
              "entity",
              "data"
            ],
            "type": "object"
          }
        ]
      },
      "webhookCommentEntity": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the comment that triggered the event."
          },
          "type": {
            "const": "comment",
            "description": "Always `comment`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "id"
        ],
        "type": "object"
      },
      "webhookDatabaseEventEntity": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the database or data source that triggered the event."
          },
          "type": {
            "description": "The type of entity. For linked databases, this is `block`.",
            "enum": [
              "block",
              "database",
              "data_source"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "webhookExternalBlock": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent."
          },
          "type": {
            "description": "The type of the parent.",
            "enum": [
              "page",
              "database",
              "block"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "webhookFileUploadEntity": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the file upload that triggered the event."
          },
          "type": {
            "const": "file_upload",
            "description": "Always `file_upload`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "id"
        ],
        "type": "object"
      },
      "webhookPageEntity": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the page that triggered the event."
          },
          "type": {
            "const": "page",
            "description": "Always `page`",
            "type": "string"
          }
        },
        "required": [
          "type",
          "id"
        ],
        "type": "object"
      },
      "webhookParentBlock": {
        "additionalProperties": false,
        "properties": {
          "data_source_id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The data source ID of the parent, if applicable."
          },
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the parent."
          },
          "type": {
            "description": "The type of the parent.",
            "enum": [
              "space",
              "block",
              "page",
              "database",
              "team",
              "agent"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "webhookUpdatedBlock": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the updated block."
          },
          "type": {
            "description": "The type of the updated block.",
            "enum": [
              "page",
              "database",
              "block"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "webhookViewEntity": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "$ref": "#/components/schemas/idResponse",
            "description": "The ID of the view that triggered the event."
          },
          "type": {
            "const": "view",
            "description": "Always `view`",
            "type": "string"
          }
        },
        "required": [
          "id",
          "type"
        ],
        "type": "object"
      },
      "widgetPlacementRequest": {
        "description": "Where to place the new widget in the dashboard. \"new_row\" creates a new row, \"existing_row\" adds to an existing row side-by-side with other widgets.",
        "oneOf": [
          {
            "properties": {
              "row_index": {
                "description": "The 0-based row position to insert the new row at. If omitted, the new row is appended at the end.",
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "const": "new_row",
                "description": "Placement type. \"new_row\" creates a new row containing the widget.",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "properties": {
              "row_index": {
                "description": "The 0-based index of the existing row to add the widget to.",
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "const": "existing_row",
                "description": "Placement type. \"existing_row\" adds the widget to an existing row (side-by-side with other widgets).",
                "type": "string"
              }
            },
            "required": [
              "type",
              "row_index"
            ],
            "type": "object"
          }
        ]
      },
      "workspaceParentForBlockBasedObjectResponse": {
        "additionalProperties": true,
        "properties": {
          "type": {
            "const": "workspace",
            "description": "The parent type.",
            "type": "string"
          },
          "workspace": {
            "const": true,
            "description": "Always true for workspace parent.",
            "type": "boolean"
          }
        },
        "required": [
          "type",
          "workspace"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "scheme": "basic",
        "type": "http"
      },
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "termsOfService": "https://notion.notion.site/Terms-and-Privacy-28ffdd083dc3473e9c2da6ec011b58ac",
    "title": "Notion API",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/agents/batch": {
      "post": {
        "operationId": "agent-batch",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "operations": {
                    "description": "The operations to apply, at least one and at most 100. Operations are applied in the order given, and the batch is not atomic: each operation succeeds or fails on its own, and per-operation outcomes are reported in the async task's result.",
                    "items": {
                      "description": "One action to apply to one agent. Each operation is authorized and applied on its own.",
                      "oneOf": [
                        {
                          "additionalProperties": false,
                          "properties": {
                            "action": {
                              "const": "update_status",
                              "description": "Enable or disable one agent, equivalent to `PATCH /v1/agents/:agent_id/status`.",
                              "type": "string"
                            },
                            "agent_id": {
                              "anyOf": [
                                {
                                  "$ref": "#/components/schemas/idRequest"
                                },
                                {
                                  "const": "notion_ai",
                                  "description": "Always `notion_ai`",
                                  "type": "string"
                                }
                              ],
                              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
                            },
                            "fields": {
                              "additionalProperties": false,
                              "description": "The status to apply to this agent.",
                              "properties": {
                                "status": {
                                  "description": "\"active\" to re-enable an agent disabled through this API, or \"disabled\" to turn it off.",
                                  "enum": [
                                    "active",
                                    "disabled"
                                  ],
                                  "type": "string"
                                }
                              },
                              "required": [
                                "status"
                              ],
                              "type": "object"
                            }
                          },
                          "required": [
                            "action",
                            "agent_id",
                            "fields"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": false,
                          "properties": {
                            "action": {
                              "const": "update_credit_limit",
                              "description": "Set or clear one agent's credit limit, equivalent to `PATCH /v1/agents/:agent_id/credit_limit`. Requires a personal access token whose user has full access to the agent.",
                              "type": "string"
                            },
                            "agent_id": {
                              "anyOf": [
                                {
                                  "$ref": "#/components/schemas/idRequest"
                                },
                                {
                                  "const": "notion_ai",
                                  "description": "Always `notion_ai`",
                                  "type": "string"
                                }
                              ],
                              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
                            },
                            "fields": {
                              "additionalProperties": false,
                              "description": "The credit limit to apply to this agent.",
                              "properties": {
                                "credit_limit": {
                                  "description": "The per-agent credit limit as a non-negative integer, or null to clear the limit.",
                                  "oneOf": [
                                    {
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "credit_limit"
                              ],
                              "type": "object"
                            }
                          },
                          "required": [
                            "action",
                            "agent_id",
                            "fields"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": false,
                          "properties": {
                            "action": {
                              "const": "delete",
                              "description": "Soft-delete one agent, equivalent to `DELETE /v1/agents/:agent_id`.",
                              "type": "string"
                            },
                            "agent_id": {
                              "anyOf": [
                                {
                                  "$ref": "#/components/schemas/idRequest"
                                },
                                {
                                  "const": "notion_ai",
                                  "description": "Always `notion_ai`",
                                  "type": "string"
                                }
                              ],
                              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
                            }
                          },
                          "required": [
                            "action",
                            "agent_id"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "maxItems": 100,
                    "minItems": 1,
                    "type": "array"
                  }
                },
                "required": [
                  "operations"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "created_time": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "id": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "object": {
                      "const": "async_task",
                      "type": "string"
                    },
                    "operation": {
                      "additionalProperties": true,
                      "properties": {
                        "name": {
                          "minLength": 1,
                          "type": "string"
                        },
                        "surface": {
                          "enum": [
                            "rest",
                            "mcp"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "surface",
                        "name"
                      ],
                      "type": "object"
                    },
                    "poll_after_seconds": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "status": {
                      "enum": [
                        "queued",
                        "running",
                        "retrying"
                      ],
                      "type": "string"
                    },
                    "status_url": {
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "status",
                    "status_url",
                    "created_time",
                    "operation",
                    "poll_after_seconds"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Apply many agent operations",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.batch({\n  operations: [\n    {\n      action: \"update_status\",\n      agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\",\n      fields: { status: \"disabled\" }\n    }\n  ]\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent",
        "x-notion-sdk-method": "agents.batch"
      }
    },
    "/v1/agents/query": {
      "post": {
        "operationId": "query-agents",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "filter": {
                    "description": "Filter agents by public properties, optionally combined with and/or.",
                    "oneOf": [
                      {
                        "oneOf": [
                          {
                            "additionalProperties": false,
                            "properties": {
                              "id": {
                                "additionalProperties": false,
                                "properties": {
                                  "equals": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "equals"
                                ],
                                "type": "object"
                              },
                              "property": {
                                "const": "id",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "id"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "property": {
                                "const": "agent_type",
                                "type": "string"
                              },
                              "string": {
                                "additionalProperties": false,
                                "properties": {
                                  "equals": {
                                    "enum": [
                                      "notion_ai",
                                      "custom_agent",
                                      "autofill_custom_agent"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "equals"
                                ],
                                "type": "object"
                              }
                            },
                            "required": [
                              "property",
                              "string"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "people": {
                                "additionalProperties": false,
                                "properties": {
                                  "contains": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "contains"
                                ],
                                "type": "object"
                              },
                              "property": {
                                "const": "created_by",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "people"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "date": {
                                "additionalProperties": false,
                                "properties": {
                                  "after": {
                                    "format": "date-time",
                                    "type": "string"
                                  },
                                  "before": {
                                    "format": "date-time",
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              },
                              "property": {
                                "const": "created_time",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "date"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "checkbox": {
                                "additionalProperties": false,
                                "properties": {
                                  "equals": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "equals"
                                ],
                                "type": "object"
                              },
                              "property": {
                                "const": "favorited",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "checkbox"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "mcp_server": {
                                "additionalProperties": false,
                                "properties": {
                                  "contains": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "contains"
                                ],
                                "type": "object"
                              },
                              "property": {
                                "const": "connections",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "mcp_server"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "property": {
                                "const": "status",
                                "type": "string"
                              },
                              "status": {
                                "additionalProperties": false,
                                "properties": {
                                  "in": {
                                    "items": {
                                      "enum": [
                                        "active",
                                        "disabled",
                                        "deleted"
                                      ],
                                      "type": "string"
                                    },
                                    "minItems": 1,
                                    "type": "array"
                                  }
                                },
                                "required": [
                                  "in"
                                ],
                                "type": "object"
                              }
                            },
                            "required": [
                              "property",
                              "status"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "property": {
                                "const": "model_mode",
                                "type": "string"
                              },
                              "select": {
                                "additionalProperties": false,
                                "properties": {
                                  "equals": {
                                    "enum": [
                                      "auto",
                                      "pinned"
                                    ],
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "equals"
                                ],
                                "type": "object"
                              }
                            },
                            "required": [
                              "property",
                              "select"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "number": {
                                "additionalProperties": false,
                                "properties": {
                                  "equals": {
                                    "minimum": 1,
                                    "type": "integer"
                                  }
                                },
                                "required": [
                                  "equals"
                                ],
                                "type": "object"
                              },
                              "property": {
                                "const": "agent_version",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "number"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "date": {
                                "additionalProperties": false,
                                "properties": {
                                  "after": {
                                    "format": "date-time",
                                    "type": "string"
                                  },
                                  "before": {
                                    "format": "date-time",
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              },
                              "property": {
                                "const": "last_run_at",
                                "type": "string"
                              }
                            },
                            "required": [
                              "property",
                              "date"
                            ],
                            "type": "object"
                          }
                        ]
                      },
                      {
                        "oneOf": [
                          {
                            "additionalProperties": false,
                            "properties": {
                              "and": {
                                "items": {
                                  "oneOf": [
                                    {
                                      "oneOf": [
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "id": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "id",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "agent_type",
                                              "type": "string"
                                            },
                                            "string": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "enum": [
                                                    "notion_ai",
                                                    "custom_agent",
                                                    "autofill_custom_agent"
                                                  ],
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "string"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "people": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "contains": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "contains"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "created_by",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "people"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "date": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "after": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                },
                                                "before": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                }
                                              },
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "created_time",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "date"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "checkbox": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "favorited",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "checkbox"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "mcp_server": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "contains": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "contains"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "connections",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "mcp_server"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "status",
                                              "type": "string"
                                            },
                                            "status": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "in": {
                                                  "items": {
                                                    "enum": [
                                                      "active",
                                                      "disabled",
                                                      "deleted"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "minItems": 1,
                                                  "type": "array"
                                                }
                                              },
                                              "required": [
                                                "in"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "status"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "model_mode",
                                              "type": "string"
                                            },
                                            "select": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "enum": [
                                                    "auto",
                                                    "pinned"
                                                  ],
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "select"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "number": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "minimum": 1,
                                                  "type": "integer"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "agent_version",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "number"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "date": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "after": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                },
                                                "before": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                }
                                              },
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "last_run_at",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "date"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    },
                                    {
                                      "oneOf": [
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "and": {
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "id": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "id",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "agent_type",
                                                        "type": "string"
                                                      },
                                                      "string": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "notion_ai",
                                                              "custom_agent",
                                                              "autofill_custom_agent"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "string"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "people": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_by",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "people"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_time",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "checkbox": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "boolean"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "favorited",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "checkbox"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "mcp_server": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "connections",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "mcp_server"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "status",
                                                        "type": "string"
                                                      },
                                                      "status": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "in": {
                                                            "items": {
                                                              "enum": [
                                                                "active",
                                                                "disabled",
                                                                "deleted"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "minItems": 1,
                                                            "type": "array"
                                                          }
                                                        },
                                                        "required": [
                                                          "in"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "status"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "model_mode",
                                                        "type": "string"
                                                      },
                                                      "select": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "auto",
                                                              "pinned"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "select"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "number": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "minimum": 1,
                                                            "type": "integer"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "agent_version",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "number"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "last_run_at",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "and"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "or": {
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "id": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "id",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "agent_type",
                                                        "type": "string"
                                                      },
                                                      "string": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "notion_ai",
                                                              "custom_agent",
                                                              "autofill_custom_agent"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "string"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "people": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_by",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "people"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_time",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "checkbox": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "boolean"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "favorited",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "checkbox"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "mcp_server": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "connections",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "mcp_server"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "status",
                                                        "type": "string"
                                                      },
                                                      "status": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "in": {
                                                            "items": {
                                                              "enum": [
                                                                "active",
                                                                "disabled",
                                                                "deleted"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "minItems": 1,
                                                            "type": "array"
                                                          }
                                                        },
                                                        "required": [
                                                          "in"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "status"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "model_mode",
                                                        "type": "string"
                                                      },
                                                      "select": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "auto",
                                                              "pinned"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "select"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "number": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "minimum": 1,
                                                            "type": "integer"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "agent_version",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "number"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "last_run_at",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "or"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  ]
                                },
                                "minItems": 1,
                                "type": "array"
                              }
                            },
                            "required": [
                              "and"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": false,
                            "properties": {
                              "or": {
                                "items": {
                                  "oneOf": [
                                    {
                                      "oneOf": [
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "id": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "id",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "agent_type",
                                              "type": "string"
                                            },
                                            "string": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "enum": [
                                                    "notion_ai",
                                                    "custom_agent",
                                                    "autofill_custom_agent"
                                                  ],
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "string"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "people": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "contains": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "contains"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "created_by",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "people"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "date": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "after": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                },
                                                "before": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                }
                                              },
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "created_time",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "date"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "checkbox": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "favorited",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "checkbox"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "mcp_server": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "contains": {
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "contains"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "connections",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "mcp_server"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "status",
                                              "type": "string"
                                            },
                                            "status": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "in": {
                                                  "items": {
                                                    "enum": [
                                                      "active",
                                                      "disabled",
                                                      "deleted"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "minItems": 1,
                                                  "type": "array"
                                                }
                                              },
                                              "required": [
                                                "in"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "status"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "property": {
                                              "const": "model_mode",
                                              "type": "string"
                                            },
                                            "select": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "enum": [
                                                    "auto",
                                                    "pinned"
                                                  ],
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "select"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "number": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "equals": {
                                                  "minimum": 1,
                                                  "type": "integer"
                                                }
                                              },
                                              "required": [
                                                "equals"
                                              ],
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "agent_version",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "number"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "date": {
                                              "additionalProperties": false,
                                              "properties": {
                                                "after": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                },
                                                "before": {
                                                  "format": "date-time",
                                                  "type": "string"
                                                }
                                              },
                                              "type": "object"
                                            },
                                            "property": {
                                              "const": "last_run_at",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "property",
                                            "date"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    },
                                    {
                                      "oneOf": [
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "and": {
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "id": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "id",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "agent_type",
                                                        "type": "string"
                                                      },
                                                      "string": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "notion_ai",
                                                              "custom_agent",
                                                              "autofill_custom_agent"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "string"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "people": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_by",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "people"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_time",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "checkbox": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "boolean"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "favorited",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "checkbox"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "mcp_server": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "connections",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "mcp_server"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "status",
                                                        "type": "string"
                                                      },
                                                      "status": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "in": {
                                                            "items": {
                                                              "enum": [
                                                                "active",
                                                                "disabled",
                                                                "deleted"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "minItems": 1,
                                                            "type": "array"
                                                          }
                                                        },
                                                        "required": [
                                                          "in"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "status"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "model_mode",
                                                        "type": "string"
                                                      },
                                                      "select": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "auto",
                                                              "pinned"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "select"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "number": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "minimum": 1,
                                                            "type": "integer"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "agent_version",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "number"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "last_run_at",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "and"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": false,
                                          "properties": {
                                            "or": {
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "id": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "id",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "agent_type",
                                                        "type": "string"
                                                      },
                                                      "string": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "notion_ai",
                                                              "custom_agent",
                                                              "autofill_custom_agent"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "string"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "people": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_by",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "people"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "created_time",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "checkbox": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "type": "boolean"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "favorited",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "checkbox"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "mcp_server": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "contains": {
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "contains"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "connections",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "mcp_server"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "status",
                                                        "type": "string"
                                                      },
                                                      "status": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "in": {
                                                            "items": {
                                                              "enum": [
                                                                "active",
                                                                "disabled",
                                                                "deleted"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "minItems": 1,
                                                            "type": "array"
                                                          }
                                                        },
                                                        "required": [
                                                          "in"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "status"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "property": {
                                                        "const": "model_mode",
                                                        "type": "string"
                                                      },
                                                      "select": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "enum": [
                                                              "auto",
                                                              "pinned"
                                                            ],
                                                            "type": "string"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "select"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "number": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "equals": {
                                                            "minimum": 1,
                                                            "type": "integer"
                                                          }
                                                        },
                                                        "required": [
                                                          "equals"
                                                        ],
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "agent_version",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "number"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "date": {
                                                        "additionalProperties": false,
                                                        "properties": {
                                                          "after": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          },
                                                          "before": {
                                                            "format": "date-time",
                                                            "type": "string"
                                                          }
                                                        },
                                                        "type": "object"
                                                      },
                                                      "property": {
                                                        "const": "last_run_at",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "property",
                                                      "date"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "or"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  ]
                                },
                                "minItems": 1,
                                "type": "array"
                              }
                            },
                            "required": [
                              "or"
                            ],
                            "type": "object"
                          }
                        ]
                      }
                    ]
                  },
                  "include_deleted": {
                    "description": "Whether to include soft-deleted agents. Defaults to false.",
                    "type": "boolean"
                  },
                  "page_size": {
                    "description": "Number of agents to return. Maximum: 100.",
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "query": {
                    "description": "Search agent names and descriptions using a case-insensitive substring match.",
                    "type": "string"
                  },
                  "sorts": {
                    "description": "Ordered sort precedence. Defaults to created_time descending.",
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "direction": {
                          "description": "Sort direction.",
                          "enum": [
                            "ascending",
                            "descending"
                          ],
                          "type": "string"
                        },
                        "property": {
                          "description": "Timestamp used to sort agents.",
                          "enum": [
                            "created_time",
                            "last_run_at"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "property",
                        "direction"
                      ],
                      "type": "object"
                    },
                    "maxItems": 2,
                    "minItems": 1,
                    "type": "array"
                  },
                  "start_cursor": {
                    "description": "Opaque continuation cursor from the previous page.",
                    "type": "string"
                  },
                  "verbose": {
                    "description": "Whether to include inline instructions for each agent. Defaults to false.",
                    "type": "boolean"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "title": "Cursor",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "oneOf": [
                          {
                            "additionalProperties": true,
                            "properties": {
                              "agent_type": {
                                "description": "What kind of agent this is: \"custom_agent\" is a standalone agent you chat with; \"autofill_custom_agent\" fills a database property.",
                                "enum": [
                                  "custom_agent",
                                  "autofill_custom_agent"
                                ],
                                "type": "string"
                              },
                              "agent_version": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "$ref": "#/components/schemas/idResponse",
                                        "description": "The ID of the published artifact."
                                      },
                                      "number": {
                                        "description": "The version number.",
                                        "type": "number"
                                      },
                                      "published_at": {
                                        "description": "The ISO 8601 timestamp when this version was published.",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "number",
                                      "published_at"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "connections": {
                                "description": "Integrations the agent is connected to (Notion, Slack, Discord, MCP servers, and other connectors), each with an account and per-target permissions.",
                                "items": {
                                  "oneOf": [
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "type": "null"
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Content roles (\"reader\" | \"comment_only\" | \"read_and_write\" | \"editor\") for scoped targets, or search verbs (\"allow\" | \"disallow\") for the search targets.",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "page",
                                                        "description": "Always `page`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "data_source_id": {
                                                        "type": "string"
                                                      },
                                                      "property_id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "database_property",
                                                        "description": "Always `database_property`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "data_source_id",
                                                      "property_id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "agent",
                                                        "description": "Always `agent`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "workspace",
                                                        "description": "Always `workspace`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "owner_private_pages",
                                                        "description": "Always `owner_private_pages`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "allowed_domains": {
                                                        "description": "Domains web search is restricted to, or null when unrestricted.",
                                                        "oneOf": [
                                                          {
                                                            "items": {
                                                              "type": "string"
                                                            },
                                                            "maxItems": 100,
                                                            "type": "array"
                                                          },
                                                          {
                                                            "type": "null"
                                                          }
                                                        ]
                                                      },
                                                      "type": {
                                                        "const": "web_search",
                                                        "description": "Always `web_search`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "allowed_domains"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "notion_help_docs_search",
                                                        "description": "Always `notion_help_docs_search`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "notion",
                                          "description": "Always `notion`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The linked Slack workspace, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "team_id": {
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "slack_workspace",
                                                  "description": "Always `slack_workspace`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "team_id"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Slack verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "slack_channel",
                                                        "description": "Always `slack_channel`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "slack_all_public_channels",
                                                        "description": "Always `slack_all_public_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "slack_all_channels",
                                                        "description": "Always `slack_all_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "slack",
                                          "description": "Always `slack`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The linked Discord server, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "id": {
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "discord_server",
                                                  "description": "Always `discord_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "id"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Discord verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "discord_channel",
                                                        "description": "Always `discord_channel`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "discord_all_channels",
                                                        "description": "Always `discord_all_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "discord",
                                          "description": "Always `discord`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "server_host": {
                                                  "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "mcp_server",
                                                  "description": "Always `mcp_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "server_host"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "enabled_tools": {
                                          "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "items": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "name": {
                                                    "type": "string"
                                                  },
                                                  "title": {
                                                    "oneOf": [
                                                      {
                                                        "type": "string"
                                                      },
                                                      {
                                                        "type": "null"
                                                      }
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "name",
                                                  "title"
                                                ],
                                                "type": "object"
                                              },
                                              "maxItems": 100,
                                              "type": "array"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "run_tools_automatically": {
                                          "additionalProperties": true,
                                          "description": "Whether read / write tool calls run without a confirmation step.",
                                          "properties": {
                                            "read": {
                                              "description": "Whether read tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            },
                                            "write": {
                                              "description": "Whether write tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "read",
                                            "write"
                                          ],
                                          "type": "object"
                                        },
                                        "type": {
                                          "const": "mcp_server",
                                          "description": "Always `mcp_server`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "enabled_tools",
                                        "run_tools_automatically"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "server_host": {
                                                  "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "mcp_server",
                                                  "description": "Always `mcp_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "server_host"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "enabled_tools": {
                                          "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "items": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "name": {
                                                    "type": "string"
                                                  },
                                                  "title": {
                                                    "oneOf": [
                                                      {
                                                        "type": "string"
                                                      },
                                                      {
                                                        "type": "null"
                                                      }
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "name",
                                                  "title"
                                                ],
                                                "type": "object"
                                              },
                                              "maxItems": 100,
                                              "type": "array"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "run_tools_automatically": {
                                          "additionalProperties": true,
                                          "description": "Whether read / write tool calls run without a confirmation step.",
                                          "properties": {
                                            "read": {
                                              "description": "Whether read tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            },
                                            "write": {
                                              "description": "Whether write tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "read",
                                            "write"
                                          ],
                                          "type": "object"
                                        },
                                        "type": {
                                          "const": "custom_mcp_server",
                                          "description": "Always `custom_mcp_server`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "enabled_tools",
                                        "run_tools_automatically"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The provider-side account identifier, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "The scopes granted on this target.",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "id": {
                                                    "type": "string"
                                                  },
                                                  "type": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "id"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "description": "The connector's machine name (e.g. \"github\", \"google_drive\").",
                                          "enum": [
                                            "asana",
                                            "box",
                                            "calendar",
                                            "computer",
                                            "confluence",
                                            "cursor",
                                            "feedback",
                                            "files",
                                            "fs",
                                            "github",
                                            "gmail",
                                            "google_calendar",
                                            "google_drive",
                                            "google_drive_oauth",
                                            "gtm",
                                            "helpdocs",
                                            "images",
                                            "jira",
                                            "linear",
                                            "mail",
                                            "marketplace",
                                            "memory",
                                            "microsoft_teams",
                                            "microsoft_teams_oauth",
                                            "outlook",
                                            "salesforce",
                                            "search",
                                            "security",
                                            "sharepoint",
                                            "sharepoint_oauth",
                                            "shopify",
                                            "skills",
                                            "system",
                                            "test",
                                            "web",
                                            "webhooks",
                                            "worker",
                                            "workers"
                                          ],
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    }
                                  ]
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "created_by": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "$ref": "#/components/schemas/idResponse",
                                        "description": "The ID of the user or bot that created this agent."
                                      },
                                      "type": {
                                        "description": "One of: `user`, `bot`",
                                        "enum": [
                                          "user",
                                          "bot"
                                        ],
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "id"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "created_time": {
                                "description": "Date and time when this agent was created.",
                                "format": "date-time",
                                "type": "string"
                              },
                              "credit_limit": {
                                "description": "The per-agent credit limit that applies to this agent, null when uncapped, or \"hidden\" when the caller lacks full access to the agent. This is the effective limit computed at runtime, folding in both the agent's own limit and any workspace-admin default.",
                                "oneOf": [
                                  {
                                    "minimum": 0,
                                    "type": "integer"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "description": {
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "icon": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/pageIconResponse"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "custom_agent_avatar": {
                                        "additionalProperties": true,
                                        "description": "The static and animated URLs for the agent avatar.",
                                        "properties": {
                                          "animated_url": {
                                            "description": "The URL of the animated custom agent avatar.",
                                            "type": "string"
                                          },
                                          "static_url": {
                                            "description": "The URL of the static custom agent avatar.",
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "static_url",
                                          "animated_url"
                                        ],
                                        "type": "object"
                                      },
                                      "type": {
                                        "const": "custom_agent_avatar",
                                        "description": "Type of icon. In this case, a custom agent avatar.",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "custom_agent_avatar"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "id": {
                                "$ref": "#/components/schemas/idResponse"
                              },
                              "instructions": {
                                "description": "The agent's inline instructions when verbose=true, or null when its instructions are stored on a page.",
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "instructions_page_id": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/idResponse"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "last_edited_time": {
                                "description": "Date and time when this agent was last edited.",
                                "format": "date-time",
                                "type": "string"
                              },
                              "last_run_at": {
                                "description": "ISO 8601 timestamp of the agent's most recent run, null if it has never run, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "format": "date-time",
                                    "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
                                    "type": "string"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "model": {
                                "description": "The model selection: automatic, or pinned to a public model ID.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "mode": {
                                        "const": "auto",
                                        "description": "Always `auto`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "mode"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "description": "The public model this agent maps to (e.g. \"claude-sonnet-5\"), or null for a pre-release / early-access model.",
                                        "oneOf": [
                                          {
                                            "type": "string"
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "mode": {
                                        "const": "pinned",
                                        "description": "Always `pinned`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "mode",
                                      "id"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "object": {
                                "const": "agent",
                                "description": "Always `agent`",
                                "type": "string"
                              },
                              "pause_reason": {
                                "description": "Why the agent is paused when status is \"disabled\" (e.g. \"credit_limit\", \"disabled_from_workspace_settings\"); null when active.",
                                "oneOf": [
                                  {
                                    "description": "One of: `run_limit`, `credit_limit`, `runaway_credit_usage`, `workspace_credit_limit`, `owner_allowance_limit`, `failure_limit`, `mark_session_failed_autopause`, `disabled_from_workspace_settings`, `disabled_from_workspace_settings_but_resumable`, `disabled_from_api`, `disabled_from_agent_settings`, `disabled_due_to_no_members_with_access`, `disabled_due_to_lack_of_editors`, `disabled_by_notion`, `internal_error`, `needs_user_review`, `tool_unavailable`",
                                    "enum": [
                                      "run_limit",
                                      "credit_limit",
                                      "runaway_credit_usage",
                                      "workspace_credit_limit",
                                      "owner_allowance_limit",
                                      "failure_limit",
                                      "mark_session_failed_autopause",
                                      "disabled_from_workspace_settings",
                                      "disabled_from_workspace_settings_but_resumable",
                                      "disabled_from_api",
                                      "disabled_from_agent_settings",
                                      "disabled_due_to_no_members_with_access",
                                      "disabled_due_to_lack_of_editors",
                                      "disabled_by_notion",
                                      "internal_error",
                                      "needs_user_review",
                                      "tool_unavailable"
                                    ],
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "status": {
                                "description": "\"active\" when the agent can run; \"disabled\" when it is paused (see pause_reason); \"deleted\" when it has been removed.",
                                "enum": [
                                  "active",
                                  "disabled",
                                  "deleted"
                                ],
                                "type": "string"
                              },
                              "triggers": {
                                "description": "The agent's configured triggers, each with a machine type, an enabled flag, and a structured recurrence schedule when applicable.",
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "config": {
                                      "additionalProperties": {},
                                      "description": "Remaining per-type trigger configuration (e.g. watched channel ids, reaction config), keys in snake_case. Present only when the trigger carries such state.",
                                      "type": "object"
                                    },
                                    "enabled": {
                                      "description": "Whether this trigger is currently enabled.",
                                      "type": "boolean"
                                    },
                                    "schedule": {
                                      "additionalProperties": true,
                                      "description": "Structured recurrence cadence. Present only for recurrence triggers.",
                                      "properties": {
                                        "end": {
                                          "description": "When the schedule stops, when it is bounded.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "end_at": {
                                                  "description": "ISO 8601 timestamp when the schedule stops.",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "date",
                                                  "description": "Always `date`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "end_at"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "occurrences": {
                                                  "description": "Number of occurrences after which the schedule stops.",
                                                  "minimum": 0,
                                                  "type": "integer"
                                                },
                                                "type": {
                                                  "const": "count",
                                                  "description": "Always `count`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "occurrences"
                                              ],
                                              "type": "object"
                                            }
                                          ]
                                        },
                                        "frequency": {
                                          "description": "Base cadence unit (\"hour\" | \"day\" | \"week\" | \"month\" | \"year\").",
                                          "type": "string"
                                        },
                                        "hour": {
                                          "description": "Hour of day (0–23) the schedule runs.",
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "interval": {
                                          "description": "Multiplier on the frequency (e.g. every 2 weeks).",
                                          "minimum": 1,
                                          "type": "integer"
                                        },
                                        "minute": {
                                          "description": "Minute of the hour (0–59) the schedule runs.",
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "monthdays": {
                                          "description": "Days of the month the schedule runs. Present for monthly monthday restrictions.",
                                          "items": {
                                            "minimum": 1,
                                            "type": "integer"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "start_date": {
                                          "description": "ISO 8601 timestamp the schedule starts from.",
                                          "type": "string"
                                        },
                                        "timezone": {
                                          "description": "IANA timezone (e.g. \"America/New_York\").",
                                          "type": "string"
                                        },
                                        "week_numbers": {
                                          "description": "Week-of-month ordinals for a monthly weekday restriction (e.g. [2, 3] for the 2nd and 3rd occurrence); -1 means the last week.",
                                          "items": {
                                            "type": "integer"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "weekdays": {
                                          "description": "Days of the week the schedule runs (e.g. \"monday\"). Present for weekly cadences and monthly weekday restrictions.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "frequency",
                                        "interval"
                                      ],
                                      "type": "object"
                                    },
                                    "type": {
                                      "description": "Machine trigger type (e.g. \"notion.agent.mentioned\", \"recurrence\", \"slack.reaction.added\").",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "enabled"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "agent_type",
                              "name",
                              "description",
                              "instructions_page_id",
                              "icon",
                              "model",
                              "connections",
                              "status",
                              "pause_reason",
                              "created_by",
                              "agent_version",
                              "created_time",
                              "last_edited_time",
                              "last_run_at",
                              "credit_limit",
                              "triggers"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "agent_type": {
                                "const": "notion_ai",
                                "description": "Always `notion_ai`",
                                "type": "string"
                              },
                              "agent_version": {
                                "type": "null"
                              },
                              "connections": {
                                "items": {
                                  "oneOf": [
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "type": "null"
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Content roles (\"reader\" | \"comment_only\" | \"read_and_write\" | \"editor\") for scoped targets, or search verbs (\"allow\" | \"disallow\") for the search targets.",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "page",
                                                        "description": "Always `page`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "data_source_id": {
                                                        "type": "string"
                                                      },
                                                      "property_id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "database_property",
                                                        "description": "Always `database_property`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "data_source_id",
                                                      "property_id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "agent",
                                                        "description": "Always `agent`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "workspace",
                                                        "description": "Always `workspace`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "owner_private_pages",
                                                        "description": "Always `owner_private_pages`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "allowed_domains": {
                                                        "description": "Domains web search is restricted to, or null when unrestricted.",
                                                        "oneOf": [
                                                          {
                                                            "items": {
                                                              "type": "string"
                                                            },
                                                            "maxItems": 100,
                                                            "type": "array"
                                                          },
                                                          {
                                                            "type": "null"
                                                          }
                                                        ]
                                                      },
                                                      "type": {
                                                        "const": "web_search",
                                                        "description": "Always `web_search`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "allowed_domains"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "notion_help_docs_search",
                                                        "description": "Always `notion_help_docs_search`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "notion",
                                          "description": "Always `notion`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The linked Slack workspace, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "team_id": {
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "slack_workspace",
                                                  "description": "Always `slack_workspace`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "team_id"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Slack verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "slack_channel",
                                                        "description": "Always `slack_channel`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "slack_all_public_channels",
                                                        "description": "Always `slack_all_public_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "slack_all_channels",
                                                        "description": "Always `slack_all_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "slack",
                                          "description": "Always `slack`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The linked Discord server, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "id": {
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "discord_server",
                                                  "description": "Always `discord_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "id"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "Discord verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "oneOf": [
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "id": {
                                                        "type": "string"
                                                      },
                                                      "type": {
                                                        "const": "discord_channel",
                                                        "description": "Always `discord_channel`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "id"
                                                    ],
                                                    "type": "object"
                                                  },
                                                  {
                                                    "additionalProperties": true,
                                                    "properties": {
                                                      "type": {
                                                        "const": "discord_all_channels",
                                                        "description": "Always `discord_all_channels`",
                                                        "type": "string"
                                                      }
                                                    },
                                                    "required": [
                                                      "type"
                                                    ],
                                                    "type": "object"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "const": "discord",
                                          "description": "Always `discord`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "server_host": {
                                                  "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "mcp_server",
                                                  "description": "Always `mcp_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "server_host"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "enabled_tools": {
                                          "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "items": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "name": {
                                                    "type": "string"
                                                  },
                                                  "title": {
                                                    "oneOf": [
                                                      {
                                                        "type": "string"
                                                      },
                                                      {
                                                        "type": "null"
                                                      }
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "name",
                                                  "title"
                                                ],
                                                "type": "object"
                                              },
                                              "maxItems": 100,
                                              "type": "array"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "run_tools_automatically": {
                                          "additionalProperties": true,
                                          "description": "Whether read / write tool calls run without a confirmation step.",
                                          "properties": {
                                            "read": {
                                              "description": "Whether read tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            },
                                            "write": {
                                              "description": "Whether write tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "read",
                                            "write"
                                          ],
                                          "type": "object"
                                        },
                                        "type": {
                                          "const": "mcp_server",
                                          "description": "Always `mcp_server`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "enabled_tools",
                                        "run_tools_automatically"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "server_host": {
                                                  "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "mcp_server",
                                                  "description": "Always `mcp_server`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "server_host"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "enabled_tools": {
                                          "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "items": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "name": {
                                                    "type": "string"
                                                  },
                                                  "title": {
                                                    "oneOf": [
                                                      {
                                                        "type": "string"
                                                      },
                                                      {
                                                        "type": "null"
                                                      }
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "name",
                                                  "title"
                                                ],
                                                "type": "object"
                                              },
                                              "maxItems": 100,
                                              "type": "array"
                                            },
                                            {
                                              "const": "hidden",
                                              "description": "Always `hidden`",
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "run_tools_automatically": {
                                          "additionalProperties": true,
                                          "description": "Whether read / write tool calls run without a confirmation step.",
                                          "properties": {
                                            "read": {
                                              "description": "Whether read tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            },
                                            "write": {
                                              "description": "Whether write tool calls run without a confirmation step.",
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "read",
                                            "write"
                                          ],
                                          "type": "object"
                                        },
                                        "type": {
                                          "const": "custom_mcp_server",
                                          "description": "Always `custom_mcp_server`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "enabled_tools",
                                        "run_tools_automatically"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "account": {
                                          "description": "The provider-side account identifier, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "permissions": {
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "scopes": {
                                                "description": "The scopes granted on this target.",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "maxItems": 100,
                                                "type": "array"
                                              },
                                              "target": {
                                                "additionalProperties": true,
                                                "properties": {
                                                  "id": {
                                                    "type": "string"
                                                  },
                                                  "type": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "id"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "scopes"
                                            ],
                                            "type": "object"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "type": {
                                          "description": "The connector's machine name (e.g. \"github\", \"google_drive\").",
                                          "enum": [
                                            "asana",
                                            "box",
                                            "calendar",
                                            "computer",
                                            "confluence",
                                            "cursor",
                                            "feedback",
                                            "files",
                                            "fs",
                                            "github",
                                            "gmail",
                                            "google_calendar",
                                            "google_drive",
                                            "google_drive_oauth",
                                            "gtm",
                                            "helpdocs",
                                            "images",
                                            "jira",
                                            "linear",
                                            "mail",
                                            "marketplace",
                                            "memory",
                                            "microsoft_teams",
                                            "microsoft_teams_oauth",
                                            "outlook",
                                            "salesforce",
                                            "search",
                                            "security",
                                            "sharepoint",
                                            "sharepoint_oauth",
                                            "shopify",
                                            "skills",
                                            "system",
                                            "test",
                                            "web",
                                            "webhooks",
                                            "worker",
                                            "workers"
                                          ],
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "account",
                                        "permissions"
                                      ],
                                      "type": "object"
                                    }
                                  ]
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "created_by": {
                                "type": "null"
                              },
                              "created_time": {
                                "type": "null"
                              },
                              "credit_limit": {
                                "type": "null"
                              },
                              "description": {
                                "type": "null"
                              },
                              "icon": {
                                "oneOf": [
                                  {
                                    "$ref": "#/components/schemas/pageIconResponse"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "custom_agent_avatar": {
                                        "additionalProperties": true,
                                        "description": "The static and animated URLs for the agent avatar.",
                                        "properties": {
                                          "animated_url": {
                                            "description": "The URL of the animated custom agent avatar.",
                                            "type": "string"
                                          },
                                          "static_url": {
                                            "description": "The URL of the static custom agent avatar.",
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "static_url",
                                          "animated_url"
                                        ],
                                        "type": "object"
                                      },
                                      "type": {
                                        "const": "custom_agent_avatar",
                                        "description": "Type of icon. In this case, a custom agent avatar.",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "custom_agent_avatar"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              },
                              "id": {
                                "const": "notion_ai",
                                "description": "Always `notion_ai`",
                                "type": "string"
                              },
                              "instructions_page_id": {
                                "type": "null"
                              },
                              "last_edited_time": {
                                "type": "null"
                              },
                              "last_run_at": {
                                "type": "null"
                              },
                              "model": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "mode": {
                                        "const": "auto",
                                        "description": "Always `auto`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "mode"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "description": "The public model this agent maps to (e.g. \"claude-sonnet-5\"), or null for a pre-release / early-access model.",
                                        "oneOf": [
                                          {
                                            "type": "string"
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "mode": {
                                        "const": "pinned",
                                        "description": "Always `pinned`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "mode",
                                      "id"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "object": {
                                "const": "agent",
                                "description": "Always `agent`",
                                "type": "string"
                              },
                              "pause_reason": {
                                "type": "null"
                              },
                              "status": {
                                "const": "active",
                                "description": "Always `active`",
                                "type": "string"
                              },
                              "triggers": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "config": {
                                      "additionalProperties": {},
                                      "description": "Remaining per-type trigger configuration (e.g. watched channel ids, reaction config), keys in snake_case. Present only when the trigger carries such state.",
                                      "type": "object"
                                    },
                                    "enabled": {
                                      "description": "Whether this trigger is currently enabled.",
                                      "type": "boolean"
                                    },
                                    "schedule": {
                                      "additionalProperties": true,
                                      "description": "Structured recurrence cadence. Present only for recurrence triggers.",
                                      "properties": {
                                        "end": {
                                          "description": "When the schedule stops, when it is bounded.",
                                          "oneOf": [
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "end_at": {
                                                  "description": "ISO 8601 timestamp when the schedule stops.",
                                                  "type": "string"
                                                },
                                                "type": {
                                                  "const": "date",
                                                  "description": "Always `date`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "end_at"
                                              ],
                                              "type": "object"
                                            },
                                            {
                                              "additionalProperties": true,
                                              "properties": {
                                                "occurrences": {
                                                  "description": "Number of occurrences after which the schedule stops.",
                                                  "minimum": 0,
                                                  "type": "integer"
                                                },
                                                "type": {
                                                  "const": "count",
                                                  "description": "Always `count`",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "type",
                                                "occurrences"
                                              ],
                                              "type": "object"
                                            }
                                          ]
                                        },
                                        "frequency": {
                                          "description": "Base cadence unit (\"hour\" | \"day\" | \"week\" | \"month\" | \"year\").",
                                          "type": "string"
                                        },
                                        "hour": {
                                          "description": "Hour of day (0–23) the schedule runs.",
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "interval": {
                                          "description": "Multiplier on the frequency (e.g. every 2 weeks).",
                                          "minimum": 1,
                                          "type": "integer"
                                        },
                                        "minute": {
                                          "description": "Minute of the hour (0–59) the schedule runs.",
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "monthdays": {
                                          "description": "Days of the month the schedule runs. Present for monthly monthday restrictions.",
                                          "items": {
                                            "minimum": 1,
                                            "type": "integer"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "start_date": {
                                          "description": "ISO 8601 timestamp the schedule starts from.",
                                          "type": "string"
                                        },
                                        "timezone": {
                                          "description": "IANA timezone (e.g. \"America/New_York\").",
                                          "type": "string"
                                        },
                                        "week_numbers": {
                                          "description": "Week-of-month ordinals for a monthly weekday restriction (e.g. [2, 3] for the 2nd and 3rd occurrence); -1 means the last week.",
                                          "items": {
                                            "type": "integer"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        },
                                        "weekdays": {
                                          "description": "Days of the week the schedule runs (e.g. \"monday\"). Present for weekly cadences and monthly weekday restrictions.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 100,
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "frequency",
                                        "interval"
                                      ],
                                      "type": "object"
                                    },
                                    "type": {
                                      "description": "Machine trigger type (e.g. \"notion.agent.mentioned\", \"recurrence\", \"slack.reaction.added\").",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "enabled"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "agent_type",
                              "name",
                              "description",
                              "instructions_page_id",
                              "icon",
                              "model",
                              "connections",
                              "status",
                              "pause_reason",
                              "created_by",
                              "agent_version",
                              "created_time",
                              "last_edited_time",
                              "last_run_at",
                              "credit_limit",
                              "triggers"
                            ],
                            "type": "object"
                          }
                        ]
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "type": {
                      "const": "agent",
                      "description": "Always `agent`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "type",
                    "results",
                    "has_more",
                    "next_cursor"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Query agents",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.query({\n  filter: { property: \"agent_type\", string: { equals: \"custom_agent\" } },\n  sorts: [{ property: \"created_time\", direction: \"descending\" }],\n  page_size: 10\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/query-agents",
        "x-notion-sdk-method": "agents.query"
      }
    },
    "/v1/agents/{agent_id}": {
      "delete": {
        "operationId": "delete-agent",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. The personal agent cannot be deleted."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_id": {
                      "$ref": "#/components/schemas/idResponse"
                    },
                    "deleted_at": {
                      "description": "ISO 8601 timestamp of when the agent was deleted.",
                      "type": "string"
                    },
                    "status": {
                      "const": "deleted",
                      "description": "Always \"deleted\": the agent has been soft-deleted (recoverable).",
                      "type": "string"
                    }
                  },
                  "required": [
                    "agent_id",
                    "status",
                    "deleted_at"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Delete agent",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.delete({\n  agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/delete-agent",
        "x-notion-sdk-method": "agents.delete"
      },
      "get": {
        "operationId": "get-agent",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
            }
          },
          {
            "in": "query",
            "name": "verbose",
            "schema": {
              "description": "Whether to include the agent's inline instructions. Defaults to false.",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_type": {
                      "description": "What kind of agent this is: \"notion_ai\" is the personal agent; \"custom_agent\" is a standalone agent you chat with; \"autofill_custom_agent\" fills a database property; \"external\" runs through an external provider.",
                      "enum": [
                        "notion_ai",
                        "custom_agent",
                        "autofill_custom_agent",
                        "external"
                      ],
                      "type": "string"
                    },
                    "agent_version": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the published artifact."
                            },
                            "number": {
                              "description": "The version number.",
                              "type": "number"
                            },
                            "published_at": {
                              "description": "The ISO 8601 timestamp when this version was published.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "number",
                            "published_at"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "connections": {
                      "description": "Integrations the agent is connected to (Notion, Slack, Discord, MCP servers, and other connectors), each with an account and per-target permissions.",
                      "items": {
                        "oneOf": [
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "type": "null"
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Content roles (\"reader\" | \"comment_only\" | \"read_and_write\" | \"editor\") for scoped targets, or search verbs (\"allow\" | \"disallow\") for the search targets.",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "page",
                                              "description": "Always `page`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "data_source_id": {
                                              "type": "string"
                                            },
                                            "property_id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "database_property",
                                              "description": "Always `database_property`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "data_source_id",
                                            "property_id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "agent",
                                              "description": "Always `agent`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "workspace",
                                              "description": "Always `workspace`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "owner_private_pages",
                                              "description": "Always `owner_private_pages`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "allowed_domains": {
                                              "description": "Domains web search is restricted to, or null when unrestricted.",
                                              "oneOf": [
                                                {
                                                  "items": {
                                                    "type": "string"
                                                  },
                                                  "maxItems": 100,
                                                  "type": "array"
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "type": {
                                              "const": "web_search",
                                              "description": "Always `web_search`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "allowed_domains"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "notion_help_docs_search",
                                              "description": "Always `notion_help_docs_search`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "notion",
                                "description": "Always `notion`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The linked Slack workspace, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "team_id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "slack_workspace",
                                        "description": "Always `slack_workspace`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "team_id"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Slack verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "slack_channel",
                                              "description": "Always `slack_channel`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "slack_all_public_channels",
                                              "description": "Always `slack_all_public_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "slack_all_channels",
                                              "description": "Always `slack_all_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "slack",
                                "description": "Always `slack`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The linked Discord server, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "discord_server",
                                        "description": "Always `discord_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "id"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Discord verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "discord_channel",
                                              "description": "Always `discord_channel`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "discord_all_channels",
                                              "description": "Always `discord_all_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "discord",
                                "description": "Always `discord`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "server_host": {
                                        "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "mcp_server",
                                        "description": "Always `mcp_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "server_host"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "enabled_tools": {
                                "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "items": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "name": {
                                          "type": "string"
                                        },
                                        "title": {
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "title"
                                      ],
                                      "type": "object"
                                    },
                                    "maxItems": 100,
                                    "type": "array"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "run_tools_automatically": {
                                "additionalProperties": true,
                                "description": "Whether read / write tool calls run without a confirmation step.",
                                "properties": {
                                  "read": {
                                    "description": "Whether read tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  },
                                  "write": {
                                    "description": "Whether write tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "read",
                                  "write"
                                ],
                                "type": "object"
                              },
                              "type": {
                                "const": "mcp_server",
                                "description": "Always `mcp_server`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "enabled_tools",
                              "run_tools_automatically"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "server_host": {
                                        "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "mcp_server",
                                        "description": "Always `mcp_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "server_host"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "enabled_tools": {
                                "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "items": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "name": {
                                          "type": "string"
                                        },
                                        "title": {
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "title"
                                      ],
                                      "type": "object"
                                    },
                                    "maxItems": 100,
                                    "type": "array"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "run_tools_automatically": {
                                "additionalProperties": true,
                                "description": "Whether read / write tool calls run without a confirmation step.",
                                "properties": {
                                  "read": {
                                    "description": "Whether read tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  },
                                  "write": {
                                    "description": "Whether write tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "read",
                                  "write"
                                ],
                                "type": "object"
                              },
                              "type": {
                                "const": "custom_mcp_server",
                                "description": "Always `custom_mcp_server`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "enabled_tools",
                              "run_tools_automatically"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The provider-side account identifier, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "The scopes granted on this target.",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "id": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "id"
                                      ],
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "description": "The connector's machine name (e.g. \"github\", \"google_drive\").",
                                "enum": [
                                  "asana",
                                  "box",
                                  "calendar",
                                  "computer",
                                  "confluence",
                                  "cursor",
                                  "feedback",
                                  "files",
                                  "fs",
                                  "github",
                                  "gmail",
                                  "google_calendar",
                                  "google_drive",
                                  "google_drive_oauth",
                                  "gtm",
                                  "helpdocs",
                                  "images",
                                  "jira",
                                  "linear",
                                  "mail",
                                  "marketplace",
                                  "memory",
                                  "microsoft_teams",
                                  "microsoft_teams_oauth",
                                  "outlook",
                                  "salesforce",
                                  "search",
                                  "security",
                                  "sharepoint",
                                  "sharepoint_oauth",
                                  "shopify",
                                  "skills",
                                  "system",
                                  "test",
                                  "web",
                                  "webhooks",
                                  "worker",
                                  "workers"
                                ],
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          }
                        ]
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "created_by": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the user that created this agent."
                            },
                            "object": {
                              "const": "user",
                              "description": "Always `user`",
                              "type": "string"
                            },
                            "type": {
                              "const": "user",
                              "description": "Always `user`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "object",
                            "type",
                            "id"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "created_time": {
                      "description": "Date and time when this agent was created.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "credit_limit": {
                      "description": "The per-agent credit limit that applies to this agent, null when uncapped, or \"hidden\" when the caller lacks full access to the agent. This is the effective limit computed at runtime, folding in both the agent's own limit and any workspace-admin default.",
                      "oneOf": [
                        {
                          "minimum": 0,
                          "type": "integer"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "has_unpublished_changes": {
                      "description": "Whether the draft has edits not yet in the published version, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        }
                      ]
                    },
                    "icon": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/pageIconResponse"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "custom_agent_avatar": {
                              "additionalProperties": true,
                              "description": "The static and animated URLs for the agent avatar.",
                              "properties": {
                                "animated_url": {
                                  "description": "The URL of the animated custom agent avatar.",
                                  "type": "string"
                                },
                                "static_url": {
                                  "description": "The URL of the static custom agent avatar.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "static_url",
                                "animated_url"
                              ],
                              "type": "object"
                            },
                            "type": {
                              "const": "custom_agent_avatar",
                              "description": "Type of icon. In this case, a custom agent avatar.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "custom_agent_avatar"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "id": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "const": "notion_ai",
                          "description": "Always `notion_ai`",
                          "type": "string"
                        }
                      ]
                    },
                    "instructions": {
                      "description": "The agent's inline instructions when verbose=true, or null when its instructions are stored on a page.",
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "instructions_page_id": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "is_favorited": {
                      "description": "Whether this agent is in the caller's personal favorites, or null when the caller has no personal favorites scope.",
                      "oneOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_edited_time": {
                      "description": "Date and time when this agent was last edited.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "last_run_at": {
                      "description": "ISO 8601 timestamp of the agent's most recent run, null if it has never run, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "format": "date-time",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
                          "type": "string"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_run_time": {
                      "description": "ISO 8601 timestamp of the agent's most recent run, null if it has never run, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "format": "date-time",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
                          "type": "string"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "model": {
                      "description": "The model the agent runs on: auto (Notion selects) or a pinned model.",
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "mode": {
                              "const": "auto",
                              "description": "Always `auto`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "description": "The public model this agent maps to (e.g. \"claude-sonnet-5\"), or null for a pre-release / early-access model.",
                              "oneOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "mode": {
                              "const": "pinned",
                              "description": "Always `pinned`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode",
                            "id"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "object": {
                      "const": "agent",
                      "description": "Always `agent`",
                      "type": "string"
                    },
                    "pause_reason": {
                      "description": "Why the agent is paused when status is \"disabled\" (e.g. \"credit_limit\", \"disabled_from_workspace_settings\"); null when active.",
                      "oneOf": [
                        {
                          "description": "One of: `run_limit`, `credit_limit`, `runaway_credit_usage`, `workspace_credit_limit`, `owner_allowance_limit`, `failure_limit`, `mark_session_failed_autopause`, `disabled_from_workspace_settings`, `disabled_from_workspace_settings_but_resumable`, `disabled_from_api`, `disabled_from_agent_settings`, `disabled_due_to_no_members_with_access`, `disabled_due_to_lack_of_editors`, `disabled_by_notion`, `internal_error`, `needs_user_review`, `tool_unavailable`",
                          "enum": [
                            "run_limit",
                            "credit_limit",
                            "runaway_credit_usage",
                            "workspace_credit_limit",
                            "owner_allowance_limit",
                            "failure_limit",
                            "mark_session_failed_autopause",
                            "disabled_from_workspace_settings",
                            "disabled_from_workspace_settings_but_resumable",
                            "disabled_from_api",
                            "disabled_from_agent_settings",
                            "disabled_due_to_no_members_with_access",
                            "disabled_due_to_lack_of_editors",
                            "disabled_by_notion",
                            "internal_error",
                            "needs_user_review",
                            "tool_unavailable"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "status": {
                      "description": "\"active\" when the agent can run; \"disabled\" when it is paused (see pause_reason); \"deleted\" when it has been removed.",
                      "enum": [
                        "active",
                        "disabled",
                        "deleted"
                      ],
                      "type": "string"
                    },
                    "triggers": {
                      "description": "The agent's configured triggers, each with a machine type, an enabled flag, and (for recurrence triggers) a structured schedule.",
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "config": {
                            "additionalProperties": {},
                            "description": "Remaining per-type trigger configuration (e.g. watched channel ids, reaction config), keys in snake_case. Present only when the trigger carries such state.",
                            "type": "object"
                          },
                          "enabled": {
                            "description": "Whether this trigger is currently enabled.",
                            "type": "boolean"
                          },
                          "schedule": {
                            "additionalProperties": true,
                            "description": "Structured recurrence cadence. Present only for recurrence triggers.",
                            "properties": {
                              "end": {
                                "description": "When the schedule stops, when it is bounded.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "end_at": {
                                        "description": "ISO 8601 timestamp when the schedule stops.",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "date",
                                        "description": "Always `date`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "end_at"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "occurrences": {
                                        "description": "Number of occurrences after which the schedule stops.",
                                        "minimum": 0,
                                        "type": "integer"
                                      },
                                      "type": {
                                        "const": "count",
                                        "description": "Always `count`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "occurrences"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              },
                              "frequency": {
                                "description": "Base cadence unit (\"hour\" | \"day\" | \"week\" | \"month\" | \"year\").",
                                "type": "string"
                              },
                              "hour": {
                                "description": "Hour of day (0–23) the schedule runs.",
                                "minimum": 0,
                                "type": "integer"
                              },
                              "interval": {
                                "description": "Multiplier on the frequency (e.g. every 2 weeks).",
                                "minimum": 1,
                                "type": "integer"
                              },
                              "minute": {
                                "description": "Minute of the hour (0–59) the schedule runs.",
                                "minimum": 0,
                                "type": "integer"
                              },
                              "monthdays": {
                                "description": "Days of the month the schedule runs. Present for monthly monthday restrictions.",
                                "items": {
                                  "minimum": 1,
                                  "type": "integer"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "start_date": {
                                "description": "ISO 8601 timestamp the schedule starts from.",
                                "type": "string"
                              },
                              "timezone": {
                                "description": "IANA timezone (e.g. \"America/New_York\").",
                                "type": "string"
                              },
                              "week_numbers": {
                                "description": "Week-of-month ordinals for a monthly weekday restriction (e.g. [2, 3] for the 2nd and 3rd occurrence); -1 means the last week.",
                                "items": {
                                  "type": "integer"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "weekdays": {
                                "description": "Days of the week the schedule runs (e.g. \"monday\"). Present for weekly cadences and monthly weekday restrictions.",
                                "items": {
                                  "type": "string"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "frequency",
                              "interval"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "description": "Machine trigger type (e.g. \"notion.agent.mentioned\", \"recurrence\", \"slack.reaction.added\").",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "enabled"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "version": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the published artifact."
                            },
                            "number": {
                              "description": "The version number.",
                              "type": "number"
                            },
                            "published_at": {
                              "description": "The ISO 8601 timestamp when this version was published.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "number",
                            "published_at"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "agent_type",
                    "name",
                    "description",
                    "instructions_page_id",
                    "icon",
                    "model",
                    "connections",
                    "status",
                    "pause_reason",
                    "created_by",
                    "version",
                    "agent_version",
                    "has_unpublished_changes",
                    "last_run_time",
                    "last_run_at",
                    "credit_limit",
                    "triggers",
                    "is_favorited"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Get agent",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.retrieve({\n  agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/retrieve-agent",
        "x-notion-sdk-method": "agents.retrieve"
      },
      "patch": {
        "operationId": "update-agent",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "description": {
                    "description": "The custom agent's short description. Use an empty string to clear it.",
                    "type": "string"
                  },
                  "is_favorited": {
                    "description": "Whether the personal-access-token owner has this agent in their favorites.",
                    "type": "boolean"
                  },
                  "model": {
                    "description": "The model selection. Use auto to let Notion choose, or pinned with an available public model ID.",
                    "oneOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "mode": {
                            "const": "auto",
                            "description": "Let Notion select the model for each run.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "mode"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "id": {
                            "description": "A public model ID, such as `claude-sonnet-5`. It must currently be available to the caller in this workspace.",
                            "type": "string"
                          },
                          "mode": {
                            "const": "pinned",
                            "description": "Use the selected model for each run after publishing the agent.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "mode",
                          "id"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "name": {
                    "description": "The agent's display name.",
                    "type": "string"
                  },
                  "status": {
                    "description": "Enable or disable the agent. Re-enabling works only for an agent an editor disabled, through the API or in agent settings.",
                    "enum": [
                      "active",
                      "disabled"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_type": {
                      "description": "What kind of agent this is: \"notion_ai\" is the personal agent; \"custom_agent\" is a standalone agent you chat with; \"autofill_custom_agent\" fills a database property; \"external\" runs through an external provider.",
                      "enum": [
                        "notion_ai",
                        "custom_agent",
                        "autofill_custom_agent",
                        "external"
                      ],
                      "type": "string"
                    },
                    "agent_version": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the published artifact."
                            },
                            "number": {
                              "description": "The version number.",
                              "type": "number"
                            },
                            "published_at": {
                              "description": "The ISO 8601 timestamp when this version was published.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "number",
                            "published_at"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "connections": {
                      "description": "Integrations the agent is connected to (Notion, Slack, Discord, MCP servers, and other connectors), each with an account and per-target permissions.",
                      "items": {
                        "oneOf": [
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "type": "null"
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Content roles (\"reader\" | \"comment_only\" | \"read_and_write\" | \"editor\") for scoped targets, or search verbs (\"allow\" | \"disallow\") for the search targets.",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "page",
                                              "description": "Always `page`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "data_source_id": {
                                              "type": "string"
                                            },
                                            "property_id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "database_property",
                                              "description": "Always `database_property`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "data_source_id",
                                            "property_id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "agent",
                                              "description": "Always `agent`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "workspace",
                                              "description": "Always `workspace`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "owner_private_pages",
                                              "description": "Always `owner_private_pages`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "allowed_domains": {
                                              "description": "Domains web search is restricted to, or null when unrestricted.",
                                              "oneOf": [
                                                {
                                                  "items": {
                                                    "type": "string"
                                                  },
                                                  "maxItems": 100,
                                                  "type": "array"
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "type": {
                                              "const": "web_search",
                                              "description": "Always `web_search`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "allowed_domains"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "notion_help_docs_search",
                                              "description": "Always `notion_help_docs_search`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "notion",
                                "description": "Always `notion`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The linked Slack workspace, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "team_id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "slack_workspace",
                                        "description": "Always `slack_workspace`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "team_id"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Slack verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "slack_channel",
                                              "description": "Always `slack_channel`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "slack_all_public_channels",
                                              "description": "Always `slack_all_public_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "slack_all_channels",
                                              "description": "Always `slack_all_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "slack",
                                "description": "Always `slack`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The linked Discord server, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "discord_server",
                                        "description": "Always `discord_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "id"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "Discord verbs granted on this target (\"read\" | \"write\" | \"reply_in_thread\" | \"react\").",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "oneOf": [
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "id": {
                                              "type": "string"
                                            },
                                            "type": {
                                              "const": "discord_channel",
                                              "description": "Always `discord_channel`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "id"
                                          ],
                                          "type": "object"
                                        },
                                        {
                                          "additionalProperties": true,
                                          "properties": {
                                            "type": {
                                              "const": "discord_all_channels",
                                              "description": "Always `discord_all_channels`",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "const": "discord",
                                "description": "Always `discord`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "server_host": {
                                        "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "mcp_server",
                                        "description": "Always `mcp_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "server_host"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "enabled_tools": {
                                "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "items": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "name": {
                                          "type": "string"
                                        },
                                        "title": {
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "title"
                                      ],
                                      "type": "object"
                                    },
                                    "maxItems": 100,
                                    "type": "array"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "run_tools_automatically": {
                                "additionalProperties": true,
                                "description": "Whether read / write tool calls run without a confirmation step.",
                                "properties": {
                                  "read": {
                                    "description": "Whether read tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  },
                                  "write": {
                                    "description": "Whether write tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "read",
                                  "write"
                                ],
                                "type": "object"
                              },
                              "type": {
                                "const": "mcp_server",
                                "description": "Always `mcp_server`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "enabled_tools",
                              "run_tools_automatically"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The MCP server host, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "server_host": {
                                        "description": "The MCP server host (never the full URL, which can carry credentials or private path components).",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "mcp_server",
                                        "description": "Always `mcp_server`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "server_host"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "enabled_tools": {
                                "description": "The tools the agent may call, null when all tools are enabled (including any the server adds later), or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "items": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "name": {
                                          "type": "string"
                                        },
                                        "title": {
                                          "oneOf": [
                                            {
                                              "type": "string"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "title"
                                      ],
                                      "type": "object"
                                    },
                                    "maxItems": 100,
                                    "type": "array"
                                  },
                                  {
                                    "const": "hidden",
                                    "description": "Always `hidden`",
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "run_tools_automatically": {
                                "additionalProperties": true,
                                "description": "Whether read / write tool calls run without a confirmation step.",
                                "properties": {
                                  "read": {
                                    "description": "Whether read tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  },
                                  "write": {
                                    "description": "Whether write tool calls run without a confirmation step.",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "read",
                                  "write"
                                ],
                                "type": "object"
                              },
                              "type": {
                                "const": "custom_mcp_server",
                                "description": "Always `custom_mcp_server`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "enabled_tools",
                              "run_tools_automatically"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "account": {
                                "description": "The provider-side account identifier, null when none is linked, or \"hidden\" when the caller lacks edit access to the agent.",
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "permissions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "scopes": {
                                      "description": "The scopes granted on this target.",
                                      "items": {
                                        "type": "string"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "target": {
                                      "additionalProperties": true,
                                      "properties": {
                                        "id": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "id"
                                      ],
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "target",
                                    "scopes"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "type": {
                                "description": "The connector's machine name (e.g. \"github\", \"google_drive\").",
                                "enum": [
                                  "asana",
                                  "box",
                                  "calendar",
                                  "computer",
                                  "confluence",
                                  "cursor",
                                  "feedback",
                                  "files",
                                  "fs",
                                  "github",
                                  "gmail",
                                  "google_calendar",
                                  "google_drive",
                                  "google_drive_oauth",
                                  "gtm",
                                  "helpdocs",
                                  "images",
                                  "jira",
                                  "linear",
                                  "mail",
                                  "marketplace",
                                  "memory",
                                  "microsoft_teams",
                                  "microsoft_teams_oauth",
                                  "outlook",
                                  "salesforce",
                                  "search",
                                  "security",
                                  "sharepoint",
                                  "sharepoint_oauth",
                                  "shopify",
                                  "skills",
                                  "system",
                                  "test",
                                  "web",
                                  "webhooks",
                                  "worker",
                                  "workers"
                                ],
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "name",
                              "account",
                              "permissions"
                            ],
                            "type": "object"
                          }
                        ]
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "created_by": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the user that created this agent."
                            },
                            "object": {
                              "const": "user",
                              "description": "Always `user`",
                              "type": "string"
                            },
                            "type": {
                              "const": "user",
                              "description": "Always `user`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "object",
                            "type",
                            "id"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "created_time": {
                      "description": "Date and time when this agent was created.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "credit_limit": {
                      "description": "The per-agent credit limit that applies to this agent, null when uncapped, or \"hidden\" when the caller lacks full access to the agent. This is the effective limit computed at runtime, folding in both the agent's own limit and any workspace-admin default.",
                      "oneOf": [
                        {
                          "minimum": 0,
                          "type": "integer"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "has_unpublished_changes": {
                      "description": "Whether the draft has edits not yet in the published version, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        }
                      ]
                    },
                    "icon": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/pageIconResponse"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "custom_agent_avatar": {
                              "additionalProperties": true,
                              "description": "The static and animated URLs for the agent avatar.",
                              "properties": {
                                "animated_url": {
                                  "description": "The URL of the animated custom agent avatar.",
                                  "type": "string"
                                },
                                "static_url": {
                                  "description": "The URL of the static custom agent avatar.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "static_url",
                                "animated_url"
                              ],
                              "type": "object"
                            },
                            "type": {
                              "const": "custom_agent_avatar",
                              "description": "Type of icon. In this case, a custom agent avatar.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "custom_agent_avatar"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "id": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "const": "notion_ai",
                          "description": "Always `notion_ai`",
                          "type": "string"
                        }
                      ]
                    },
                    "instructions": {
                      "description": "The agent's inline instructions when verbose=true, or null when its instructions are stored on a page.",
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "instructions_page_id": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "is_favorited": {
                      "description": "Whether this agent is in the caller's personal favorites, or null when the caller has no personal favorites scope.",
                      "oneOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_edited_time": {
                      "description": "Date and time when this agent was last edited.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "last_run_at": {
                      "description": "ISO 8601 timestamp of the agent's most recent run, null if it has never run, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "format": "date-time",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
                          "type": "string"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_run_time": {
                      "description": "ISO 8601 timestamp of the agent's most recent run, null if it has never run, or \"hidden\" when the caller lacks edit access to the agent.",
                      "oneOf": [
                        {
                          "format": "date-time",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
                          "type": "string"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "model": {
                      "description": "The model the agent runs on: auto (Notion selects) or a pinned model.",
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "mode": {
                              "const": "auto",
                              "description": "Always `auto`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "description": "The public model this agent maps to (e.g. \"claude-sonnet-5\"), or null for a pre-release / early-access model.",
                              "oneOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "mode": {
                              "const": "pinned",
                              "description": "Always `pinned`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode",
                            "id"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "object": {
                      "const": "agent",
                      "description": "Always `agent`",
                      "type": "string"
                    },
                    "pause_reason": {
                      "description": "Why the agent is paused when status is \"disabled\" (e.g. \"credit_limit\", \"disabled_from_workspace_settings\"); null when active.",
                      "oneOf": [
                        {
                          "description": "One of: `run_limit`, `credit_limit`, `runaway_credit_usage`, `workspace_credit_limit`, `owner_allowance_limit`, `failure_limit`, `mark_session_failed_autopause`, `disabled_from_workspace_settings`, `disabled_from_workspace_settings_but_resumable`, `disabled_from_api`, `disabled_from_agent_settings`, `disabled_due_to_no_members_with_access`, `disabled_due_to_lack_of_editors`, `disabled_by_notion`, `internal_error`, `needs_user_review`, `tool_unavailable`",
                          "enum": [
                            "run_limit",
                            "credit_limit",
                            "runaway_credit_usage",
                            "workspace_credit_limit",
                            "owner_allowance_limit",
                            "failure_limit",
                            "mark_session_failed_autopause",
                            "disabled_from_workspace_settings",
                            "disabled_from_workspace_settings_but_resumable",
                            "disabled_from_api",
                            "disabled_from_agent_settings",
                            "disabled_due_to_no_members_with_access",
                            "disabled_due_to_lack_of_editors",
                            "disabled_by_notion",
                            "internal_error",
                            "needs_user_review",
                            "tool_unavailable"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "status": {
                      "description": "\"active\" when the agent can run; \"disabled\" when it is paused (see pause_reason); \"deleted\" when it has been removed.",
                      "enum": [
                        "active",
                        "disabled",
                        "deleted"
                      ],
                      "type": "string"
                    },
                    "triggers": {
                      "description": "The agent's configured triggers, each with a machine type, an enabled flag, and (for recurrence triggers) a structured schedule.",
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "config": {
                            "additionalProperties": {},
                            "description": "Remaining per-type trigger configuration (e.g. watched channel ids, reaction config), keys in snake_case. Present only when the trigger carries such state.",
                            "type": "object"
                          },
                          "enabled": {
                            "description": "Whether this trigger is currently enabled.",
                            "type": "boolean"
                          },
                          "schedule": {
                            "additionalProperties": true,
                            "description": "Structured recurrence cadence. Present only for recurrence triggers.",
                            "properties": {
                              "end": {
                                "description": "When the schedule stops, when it is bounded.",
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "end_at": {
                                        "description": "ISO 8601 timestamp when the schedule stops.",
                                        "type": "string"
                                      },
                                      "type": {
                                        "const": "date",
                                        "description": "Always `date`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "end_at"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "occurrences": {
                                        "description": "Number of occurrences after which the schedule stops.",
                                        "minimum": 0,
                                        "type": "integer"
                                      },
                                      "type": {
                                        "const": "count",
                                        "description": "Always `count`",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "occurrences"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              },
                              "frequency": {
                                "description": "Base cadence unit (\"hour\" | \"day\" | \"week\" | \"month\" | \"year\").",
                                "type": "string"
                              },
                              "hour": {
                                "description": "Hour of day (0–23) the schedule runs.",
                                "minimum": 0,
                                "type": "integer"
                              },
                              "interval": {
                                "description": "Multiplier on the frequency (e.g. every 2 weeks).",
                                "minimum": 1,
                                "type": "integer"
                              },
                              "minute": {
                                "description": "Minute of the hour (0–59) the schedule runs.",
                                "minimum": 0,
                                "type": "integer"
                              },
                              "monthdays": {
                                "description": "Days of the month the schedule runs. Present for monthly monthday restrictions.",
                                "items": {
                                  "minimum": 1,
                                  "type": "integer"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "start_date": {
                                "description": "ISO 8601 timestamp the schedule starts from.",
                                "type": "string"
                              },
                              "timezone": {
                                "description": "IANA timezone (e.g. \"America/New_York\").",
                                "type": "string"
                              },
                              "week_numbers": {
                                "description": "Week-of-month ordinals for a monthly weekday restriction (e.g. [2, 3] for the 2nd and 3rd occurrence); -1 means the last week.",
                                "items": {
                                  "type": "integer"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "weekdays": {
                                "description": "Days of the week the schedule runs (e.g. \"monday\"). Present for weekly cadences and monthly weekday restrictions.",
                                "items": {
                                  "type": "string"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "frequency",
                              "interval"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "description": "Machine trigger type (e.g. \"notion.agent.mentioned\", \"recurrence\", \"slack.reaction.added\").",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "enabled"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "version": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "$ref": "#/components/schemas/idResponse",
                              "description": "The ID of the published artifact."
                            },
                            "number": {
                              "description": "The version number.",
                              "type": "number"
                            },
                            "published_at": {
                              "description": "The ISO 8601 timestamp when this version was published.",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "number",
                            "published_at"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "agent_type",
                    "name",
                    "description",
                    "instructions_page_id",
                    "icon",
                    "model",
                    "connections",
                    "status",
                    "pause_reason",
                    "created_by",
                    "version",
                    "agent_version",
                    "has_unpublished_changes",
                    "last_run_time",
                    "last_run_at",
                    "credit_limit",
                    "triggers",
                    "is_favorited"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update agent",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst agentId = \"1f0c7c06-781b-4987-9986-5c8dd3028013\"\nconst response = await notion.request({\n  method: \"patch\",\n  path: \"agents/\" + encodeURIComponent(agentId),\n  body: { name: \"Weekly report writer\", status: \"disabled\" }\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/update-agent"
      }
    },
    "/v1/agents/{agent_id}/credit_limit": {
      "patch": {
        "operationId": "update-agent-credit-limit",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The ID of the custom agent (a UUID). The personal agent (Notion AI) is not supported by this endpoint."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "credit_limit": {
                    "description": "The per-agent credit limit as a non-negative integer, or null to clear the limit.",
                    "oneOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "credit_limit"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_id": {
                      "$ref": "#/components/schemas/idResponse"
                    },
                    "credit_limit": {
                      "description": "The agent's editor-set per-agent credit limit; null when no limit applies.",
                      "oneOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "last_edited_time": {
                      "description": "ISO 8601 timestamp of when the agent was last edited.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "agent_id",
                    "credit_limit",
                    "last_edited_time"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update agent credit limit",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.updateCreditLimit({\n  agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\",\n  credit_limit: 500\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/update-agent-credit-limit"
      }
    },
    "/v1/agents/{agent_id}/insights": {
      "get": {
        "operationId": "get-agent-insights",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
            }
          },
          {
            "in": "query",
            "name": "start_time",
            "schema": {
              "description": "Start of the insights window, as an epoch timestamp in seconds. Must be supplied together with `end_time`; if either is omitted the window defaults to the current billing period.",
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "end_time",
            "schema": {
              "description": "End of the insights window, as an epoch timestamp in seconds. Must be supplied together with `start_time`; if either is omitted the window defaults to the current billing period.",
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_type": {
                      "description": "One of: `notion_ai`, `custom_agent`, `autofill_custom_agent`",
                      "enum": [
                        "notion_ai",
                        "custom_agent",
                        "autofill_custom_agent"
                      ],
                      "type": "string"
                    },
                    "created_by": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "type": {
                              "description": "One of: `user`, `bot`",
                              "enum": [
                                "user",
                                "bot"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "type"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "credit_limit": {
                      "description": "Enforced per-agent credit limit; null when none is configured, and \"hidden\" when the caller lacks full access to the agent.",
                      "oneOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "const": "hidden",
                          "description": "Always `hidden`",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "id": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "const": "notion_ai",
                          "description": "Always `notion_ai`",
                          "type": "string"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "object": {
                      "const": "agent_insights",
                      "description": "Always `agent_insights`",
                      "type": "string"
                    },
                    "pause_reason": {
                      "oneOf": [
                        {
                          "description": "One of: `run_limit`, `credit_limit`, `runaway_credit_usage`, `workspace_credit_limit`, `owner_allowance_limit`, `failure_limit`, `mark_session_failed_autopause`, `disabled_from_workspace_settings`, `disabled_from_workspace_settings_but_resumable`, `disabled_from_api`, `disabled_from_agent_settings`, `disabled_due_to_no_members_with_access`, `disabled_due_to_lack_of_editors`, `disabled_by_notion`, `internal_error`, `needs_user_review`, `tool_unavailable`",
                          "enum": [
                            "run_limit",
                            "credit_limit",
                            "runaway_credit_usage",
                            "workspace_credit_limit",
                            "owner_allowance_limit",
                            "failure_limit",
                            "mark_session_failed_autopause",
                            "disabled_from_workspace_settings",
                            "disabled_from_workspace_settings_but_resumable",
                            "disabled_from_api",
                            "disabled_from_agent_settings",
                            "disabled_due_to_no_members_with_access",
                            "disabled_due_to_lack_of_editors",
                            "disabled_by_notion",
                            "internal_error",
                            "needs_user_review",
                            "tool_unavailable"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "runs_completed": {
                      "description": "Number of runs recorded for this agent within the window.",
                      "type": "number"
                    },
                    "status": {
                      "description": "One of: `active`, `disabled`, `deleted`",
                      "enum": [
                        "active",
                        "disabled",
                        "deleted"
                      ],
                      "type": "string"
                    },
                    "total_credits_used": {
                      "description": "Premium AI credits consumed by this agent within the window. Values of 1 or more are whole credits, and values below 1 have at most two significant figures. Both round down.",
                      "type": "number"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "name",
                    "agent_type",
                    "status",
                    "pause_reason",
                    "created_by",
                    "total_credits_used",
                    "credit_limit",
                    "runs_completed"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Get agent insights",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.retrieveInsights({\n  agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/retrieve-agent-insights",
        "x-notion-sdk-method": "agents.retrieveInsights"
      }
    },
    "/v1/agents/{agent_id}/status": {
      "patch": {
        "deprecated": true,
        "operationId": "update-agent-status",
        "parameters": [
          {
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/idRequest"
                },
                {
                  "const": "notion_ai",
                  "description": "Always `notion_ai`",
                  "type": "string"
                }
              ],
              "description": "The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "description": "Set to \"active\" to re-enable an agent that an editor disabled, through this API or in agent settings, or \"disabled\" to turn off a running agent.",
                    "enum": [
                      "active",
                      "disabled"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "status"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_id": {
                      "$ref": "#/components/schemas/idResponse"
                    },
                    "last_edited_time": {
                      "description": "ISO 8601 timestamp of when the agent was last edited.",
                      "type": "string"
                    },
                    "pause_reason": {
                      "description": "Why the agent is paused when status is \"disabled\" (e.g. \"disabled_from_api\", \"credit_limit\"); null when active or deleted.",
                      "oneOf": [
                        {
                          "description": "One of: `run_limit`, `credit_limit`, `runaway_credit_usage`, `workspace_credit_limit`, `owner_allowance_limit`, `failure_limit`, `mark_session_failed_autopause`, `disabled_from_workspace_settings`, `disabled_from_workspace_settings_but_resumable`, `disabled_from_api`, `disabled_from_agent_settings`, `disabled_due_to_no_members_with_access`, `disabled_due_to_lack_of_editors`, `disabled_by_notion`, `internal_error`, `needs_user_review`, `tool_unavailable`",
                          "enum": [
                            "run_limit",
                            "credit_limit",
                            "runaway_credit_usage",
                            "workspace_credit_limit",
                            "owner_allowance_limit",
                            "failure_limit",
                            "mark_session_failed_autopause",
                            "disabled_from_workspace_settings",
                            "disabled_from_workspace_settings_but_resumable",
                            "disabled_from_api",
                            "disabled_from_agent_settings",
                            "disabled_due_to_no_members_with_access",
                            "disabled_due_to_lack_of_editors",
                            "disabled_by_notion",
                            "internal_error",
                            "needs_user_review",
                            "tool_unavailable"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "status": {
                      "description": "\"active\" when the agent can run; \"disabled\" when it is paused (see pause_reason); \"deleted\" when it has been removed.",
                      "enum": [
                        "active",
                        "disabled",
                        "deleted"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "agent_id",
                    "status",
                    "pause_reason",
                    "last_edited_time"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update agent status",
        "tags": [
          "Agents"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.updateStatus({\n  agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\",\n  status: \"disabled\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/update-agent-status"
      }
    },
    "/v1/ai/plugins": {
      "get": {
        "operationId": "list-skills-plugins",
        "parameters": [
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items to return. Maximum: 100.",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "An opaque cursor returned by the previous page of results.",
              "maxLength": 200,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9]+$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "description": {
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "version_id": {
                            "description": "Opaque version identifier for the plugin. Compare this value for equality to determine whether the plugin has changed.",
                            "maxLength": 64,
                            "minLength": 64,
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "description",
                          "version_id"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "type": {
                      "const": "plugin",
                      "description": "Always `plugin`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "results",
                    "next_cursor",
                    "has_more",
                    "type"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List skills plugins",
        "tags": [
          "Agent Skills"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({\n  auth: process.env.NOTION_API_KEY,\n  notionVersion: \"2026-03-11\"\n})\n\nconst response = await notion.request({\n  method: \"get\",\n  path: \"ai/plugins\",\n  query: { page_size: 100 }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/agent-skills/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/agent-skills/list-skills-plugins",
        "x-notion-sdk-method": "plugins.list"
      }
    },
    "/v1/ai/plugins/{id}": {
      "get": {
        "operationId": "get-plugin-directory",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "examples": [
                "9b4a1d3f-1f0a-4c2a-9f0b-6c1f5a3d2e10"
              ],
              "maxLength": 200,
              "minLength": 1,
              "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "url": {
                      "description": "Temporary signed URL for downloading the plugin directory as a gzipped tar archive.",
                      "type": "string"
                    },
                    "version_id": {
                      "description": "Opaque version identifier for the plugin directory. Compare this value for equality to determine whether the directory has changed. This matches the version_id in the corresponding plugin summary.",
                      "maxLength": 64,
                      "minLength": 64,
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "version_id",
                    "url"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Get a plugin directory",
        "tags": [
          "Agent Skills"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({\n  auth: process.env.NOTION_API_KEY,\n  notionVersion: \"2026-03-11\"\n})\n\nconst pluginId = \"b2d0a1f4-9c3e-4c07-9a1d-5f6e7c8b9a01\"\nconst response = await notion.request({\n  method: \"get\",\n  path: \"ai/plugins/\" + encodeURIComponent(pluginId)\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/agent-skills/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/agent-skills/get-plugin-directory",
        "x-notion-sdk-method": "plugins.retrieve"
      }
    },
    "/v1/ai/skills/{id}": {
      "get": {
        "operationId": "get-skill-directory",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Identifier for a Notion skill page."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "id": {
                      "description": "Identifier for the skill page.",
                      "format": "uuid",
                      "type": "string"
                    },
                    "url": {
                      "description": "Temporary signed URL for downloading the skill directory archive.",
                      "minLength": 1,
                      "type": "string"
                    },
                    "version_id": {
                      "description": "Stable content version for the generated skill directory.",
                      "maxLength": 64,
                      "minLength": 64,
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "version_id",
                    "url"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Get a skill directory",
        "tags": [
          "Agent Skills"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({\n  auth: process.env.NOTION_API_KEY,\n  notionVersion: \"2026-03-11\"\n})\n\nconst skillId = \"b55c9c91-384d-452b-81db-d1ef79372b75\"\nconst response = await notion.request({\n  method: \"get\",\n  path: \"ai/skills/\" + encodeURIComponent(skillId)\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/agent-skills/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/agent-skills/get-skill-directory",
        "x-notion-sdk-method": "skills.retrieve"
      }
    },
    "/v1/ai/skills/{id}/upload": {
      "post": {
        "operationId": "upload-skill",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Target page in a Skills database. Create a new page first to import a new skill."
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "file": {
                    "description": "The skill directory as a gzip-compressed tar archive (maximum 20 MiB).",
                    "format": "binary",
                    "type": "string"
                  }
                },
                "required": [
                  "file"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "page_id": {
                      "description": "Updated skill page.",
                      "format": "uuid",
                      "type": "string"
                    },
                    "status": {
                      "const": "completed",
                      "description": "Import committed.",
                      "type": "string"
                    },
                    "version_id": {
                      "description": "Content version of the uploaded skill. Matches `version_id` from GET /v1/ai/skills/{id} until the skill changes.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "status",
                    "page_id",
                    "version_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Upload a skill",
        "tags": [
          "Agent Skills"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({\n  auth: process.env.NOTION_API_KEY,\n  notionVersion: \"2026-03-11\"\n})\n\nimport { readFile } from \"fs/promises\"\n\nconst skillId = \"b55c9c91-384d-452b-81db-d1ef79372b75\"\nconst response = await notion.request({\n  method: \"post\",\n  path: \"ai/skills/\" + encodeURIComponent(skillId) + \"/upload\",\n  formDataParams: {\n    file: {\n      filename: \"skill.tar.gz\",\n      data: new Blob([await readFile(\"./skill.tar.gz\")], {\n        type: \"application/gzip\"\n      })\n    }\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/agent-skills/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/agent-skills/upload-skill"
      }
    },
    "/v1/async_tasks/{task_id}": {
      "get": {
        "operationId": "retrieve-async-task",
        "parameters": [
          {
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "description": "The ID of the async task to retrieve.",
              "examples": [
                "task_abc123"
              ],
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "additionalProperties": true,
                      "properties": {
                        "created_time": {
                          "format": "date-time",
                          "type": "string"
                        },
                        "id": {
                          "minLength": 1,
                          "type": "string"
                        },
                        "object": {
                          "const": "async_task",
                          "type": "string"
                        },
                        "operation": {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "surface": {
                              "enum": [
                                "rest",
                                "mcp"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        },
                        "poll_after_seconds": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "status": {
                          "enum": [
                            "queued",
                            "running",
                            "retrying"
                          ],
                          "type": "string"
                        },
                        "status_url": {
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "status",
                        "status_url",
                        "created_time",
                        "operation",
                        "poll_after_seconds"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": true,
                      "properties": {
                        "created_time": {
                          "format": "date-time",
                          "type": "string"
                        },
                        "id": {
                          "minLength": 1,
                          "type": "string"
                        },
                        "object": {
                          "const": "async_task",
                          "type": "string"
                        },
                        "operation": {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "surface": {
                              "enum": [
                                "rest",
                                "mcp"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        },
                        "result": {
                          "additionalProperties": {
                            "$ref": "#/components/schemas/publicApiAsyncTaskStatusResultJsonValue"
                          },
                          "type": "object"
                        },
                        "status": {
                          "const": "succeeded",
                          "type": "string"
                        },
                        "status_url": {
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "status",
                        "status_url",
                        "created_time",
                        "operation",
                        "result"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": true,
                      "properties": {
                        "created_time": {
                          "format": "date-time",
                          "type": "string"
                        },
                        "error": {
                          "oneOf": [
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "invalid_json",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "invalid_request_url",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "invalid_request",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "missing_version",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "invalid_beta",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "validation_error",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "unauthorized",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 401,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "restricted_resource",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 403,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "object_not_found",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 404,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "directory_not_found",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 404,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "rate_limited",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 429,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "service_overload",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 529,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "internal_server_error",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 500,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "service_unavailable",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 503,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "gateway_timeout",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 504,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "conflict_error",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 409,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "idempotency_key_reused",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 409,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "row_limit_exceeded",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 406,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "status_change_not_allowed",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 403,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "agent_deleted",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 409,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "invalid_credit_limit",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 400,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "workspace_credits_exhausted",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 403,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            },
                            {
                              "additionalProperties": true,
                              "properties": {
                                "additional_data": {
                                  "additionalProperties": {
                                    "oneOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      }
                                    ]
                                  },
                                  "type": "object"
                                },
                                "code": {
                                  "const": "agent_credit_limit_reached",
                                  "type": "string"
                                },
                                "message": {
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "object": {
                                  "const": "error",
                                  "type": "string"
                                },
                                "status": {
                                  "const": 403,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "object",
                                "status",
                                "code",
                                "message"
                              ],
                              "type": "object"
                            }
                          ]
                        },
                        "id": {
                          "minLength": 1,
                          "type": "string"
                        },
                        "object": {
                          "const": "async_task",
                          "type": "string"
                        },
                        "operation": {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "minLength": 1,
                              "type": "string"
                            },
                            "surface": {
                              "enum": [
                                "rest",
                                "mcp"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        },
                        "status": {
                          "const": "failed",
                          "type": "string"
                        },
                        "status_url": {
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "status",
                        "status_url",
                        "created_time",
                        "operation",
                        "error"
                      ],
                      "type": "object"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve an async task",
        "tags": [
          "Async tasks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.asyncTasks.retrieve({\n  task_id: \"task_abc123\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-async-task",
        "x-notion-sdk-method": "asyncTasks.retrieve"
      }
    },
    "/v1/blocks/meeting_notes": {
      "post": {
        "operationId": "create-meeting-note",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "properties": {
                      "language": {
                        "description": "Language hint for transcription. Defaults to automatic detection.",
                        "enum": [
                          "auto",
                          "en",
                          "zh-CN",
                          "zh-TW",
                          "es",
                          "fr",
                          "de",
                          "ja",
                          "ko",
                          "pt",
                          "ru",
                          "th",
                          "vi",
                          "id",
                          "da",
                          "fi",
                          "no",
                          "nl",
                          "it",
                          "sv",
                          "ar",
                          "he",
                          "pl"
                        ],
                        "type": "string"
                      },
                      "options": {
                        "additionalProperties": false,
                        "description": "Optional processing settings.",
                        "properties": {
                          "kickoff_summary": {
                            "description": "Whether to start summary generation after transcription.",
                            "type": "boolean"
                          }
                        },
                        "type": "object"
                      },
                      "title": {
                        "description": "Title for the meeting note.",
                        "maxLength": 2000,
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  {
                    "oneOf": [
                      {
                        "properties": {
                          "parent": {
                            "additionalProperties": false,
                            "description": "Parent page for the new meeting note.",
                            "properties": {
                              "page_id": {
                                "$ref": "#/components/schemas/idRequest",
                                "description": "Page ID where the meeting note should be created. Required for file_upload sources."
                              },
                              "type": {
                                "const": "page_id",
                                "description": "Always \"page_id\".",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "page_id"
                            ],
                            "type": "object"
                          },
                          "source": {
                            "additionalProperties": false,
                            "description": "Audio or video source for the meeting note.",
                            "properties": {
                              "file_upload_id": {
                                "$ref": "#/components/schemas/idRequest",
                                "description": "ID of a completed public API file upload."
                              },
                              "type": {
                                "const": "file_upload",
                                "description": "Always \"file_upload\".",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "file_upload_id"
                            ],
                            "type": "object"
                          }
                        },
                        "required": [
                          "source",
                          "parent"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "parent": {
                            "description": "Not accepted for block sources.",
                            "not": {}
                          },
                          "source": {
                            "additionalProperties": false,
                            "description": "Audio or video source for the meeting note.",
                            "properties": {
                              "block_id": {
                                "$ref": "#/components/schemas/idRequest",
                                "description": "ID of an existing audio, video, or file block."
                              },
                              "type": {
                                "const": "block",
                                "description": "Always \"block\".",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "block_id"
                            ],
                            "type": "object"
                          }
                        },
                        "required": [
                          "source"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "additionalProperties": true,
                      "properties": {
                        "id": {
                          "$ref": "#/components/schemas/idResponse",
                          "description": "The ID of the meeting note block."
                        },
                        "object": {
                          "const": "block",
                          "description": "Always \"block\".",
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id"
                      ],
                      "type": "object"
                    },
                    {
                      "additionalProperties": true,
                      "properties": {
                        "created_by": {
                          "$ref": "#/components/schemas/partialUserObjectResponse",
                          "description": "User who created this meeting note."
                        },
                        "created_time": {
                          "description": "ISO-8601 timestamp when this meeting note was created.",
                          "type": "string"
                        },
                        "has_children": {
                          "description": "Whether this block has child blocks.",
                          "type": "boolean"
                        },
                        "id": {
                          "$ref": "#/components/schemas/idResponse",
                          "description": "The ID of the meeting note block."
                        },
                        "in_trash": {
                          "description": "Whether this meeting note is in the trash.",
                          "type": "boolean"
                        },
                        "last_edited_by": {
                          "$ref": "#/components/schemas/partialUserObjectResponse",
                          "description": "User who last edited this meeting note."
                        },
                        "last_edited_time": {
                          "description": "ISO-8601 timestamp when this meeting note was last edited.",
                          "type": "string"
                        },
                        "meeting_notes": {
                          "additionalProperties": true,
                          "description": "Meeting note content fields.",
                          "properties": {
                            "calendar_event": {
                              "additionalProperties": true,
                              "description": "Calendar event metadata associated with this meeting note.",
                              "properties": {
                                "attendees": {
                                  "description": "List of attendee user IDs.",
                                  "items": {
                                    "$ref": "#/components/schemas/idResponse"
                                  },
                                  "maxItems": 100,
                                  "type": "array"
                                },
                                "end_time": {
                                  "description": "ISO-8601 end time of the calendar event.",
                                  "type": "string"
                                },
                                "event_id": {
                                  "description": "ID of the calendar event, as returned by the calendar tools.",
                                  "type": "string"
                                },
                                "start_time": {
                                  "description": "ISO-8601 start time of the calendar event.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "start_time",
                                "end_time"
                              ],
                              "type": "object"
                            },
                            "children": {
                              "additionalProperties": true,
                              "description": "Block IDs for each tab (summary, notes, transcript).",
                              "properties": {
                                "notes_block_id": {
                                  "$ref": "#/components/schemas/idResponse",
                                  "description": "Block ID of the meeting notes tab."
                                },
                                "summary_block_id": {
                                  "$ref": "#/components/schemas/idResponse",
                                  "description": "Block ID of the AI summary tab."
                                },
                                "transcript_block_id": {
                                  "$ref": "#/components/schemas/idResponse",
                                  "description": "Block ID of the transcript tab."
                                }
                              },
                              "type": "object"
                            },
                            "is_full_page": {
                              "description": "Whether this is a full-page meeting note.",
                              "type": "boolean"
                            },
                            "recording": {
                              "additionalProperties": true,
                              "description": "Start and end times of the actual recording.",
                              "properties": {
                                "end_time": {
                                  "description": "ISO-8601 timestamp when the recording ended.",
                                  "type": "string"
                                },
                                "start_time": {
                                  "description": "ISO-8601 timestamp when the recording started.",
                                  "type": "string"
                                }
                              },
                              "type": "object"
                            },
                            "status": {
                              "description": "Current processing status of the meeting note transcription.",
                              "enum": [
                                "transcription_not_started",
                                "transcription_paused",
                                "transcription_in_progress",
                                "transcription_failed",
                                "summary_in_progress",
                                "notes_ready"
                              ],
                              "type": "string"
                            },
                            "title": {
                              "description": "Title of the meeting note as rich text.",
                              "items": {
                                "$ref": "#/components/schemas/richTextItemResponse"
                              },
                              "maxItems": 100,
                              "type": "array"
                            }
                          },
                          "required": [
                            "is_full_page"
                          ],
                          "type": "object"
                        },
                        "object": {
                          "const": "block",
                          "description": "Always \"block\".",
                          "type": "string"
                        },
                        "type": {
                          "const": "meeting_notes",
                          "description": "Always \"meeting_notes\".",
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "type",
                        "meeting_notes",
                        "created_time",
                        "last_edited_time",
                        "created_by",
                        "last_edited_by",
                        "has_children",
                        "in_trash"
                      ],
                      "type": "object"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a meeting note",
        "tags": [
          "Meeting notes"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.meetingNotes.create({\n  source: {\n    type: \"file_upload\",\n    file_upload_id: \"a02fc1d3-db8b-45c5-a222-27595b15aea7\"\n  },\n  parent: {\n    type: \"page_id\",\n    page_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\"\n  },\n  title: \"Weekly sync\",\n  language: \"en\",\n  options: {\n    kickoff_summary: true\n  }\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-meeting-note"
      }
    },
    "/v1/blocks/meeting_notes/query": {
      "post": {
        "operationId": "query-meeting-notes",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "filter": {
                    "description": "Optional filter for querying meeting notes. Supports combinator (and/or) and property filters on title, attendees, created_time, created_by, last_edited_time, last_edited_by.",
                    "properties": {
                      "filters": {
                        "description": "Nested filters; each may be a combinator (and/or) or property filter.",
                        "items": {
                          "oneOf": [
                            {
                              "$ref": "#/components/schemas/meetingNotesPropertyFilter"
                            },
                            {
                              "additionalProperties": false,
                              "properties": {
                                "filters": {
                                  "description": "The conditions in this group. A group with no conditions matches nothing, so send at least one.",
                                  "items": {
                                    "$ref": "#/components/schemas/meetingNotesPropertyFilter"
                                  },
                                  "maxItems": 100,
                                  "type": "array"
                                },
                                "operator": {
                                  "description": "Whether every child must match, or any of them.",
                                  "enum": [
                                    "and",
                                    "or"
                                  ],
                                  "type": "string"
                                }
                              },
                              "required": [
                                "operator",
                                "filters"
                              ],
                              "type": "object"
                            }
                          ]
                        },
                        "maxItems": 100,
                        "type": "array"
                      },
                      "operator": {
                        "description": "Operator for combinator filters.",
                        "enum": [
                          "and",
                          "or"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "operator"
                    ],
                    "type": "object"
                  },
                  "limit": {
                    "description": "Maximum number of results to return. Defaults to 50.",
                    "maximum": 50,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "sort": {
                    "description": "Optional sort order for the results. Each entry specifies a property name and direction.",
                    "items": {
                      "properties": {
                        "direction": {
                          "description": "Sort direction. Must be 'ascending' or 'descending'.",
                          "enum": [
                            "ascending",
                            "descending"
                          ],
                          "type": "string"
                        },
                        "property": {
                          "description": "Property name to sort by.",
                          "enum": [
                            "title",
                            "attendees",
                            "created_time",
                            "created_by",
                            "last_edited_time",
                            "last_edited_by"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "property",
                        "direction"
                      ],
                      "type": "object"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "description": "Whether additional results exist beyond the returned limit.",
                      "type": "boolean"
                    },
                    "results": {
                      "description": "Meeting note block objects.",
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "created_by": {
                            "$ref": "#/components/schemas/partialUserObjectResponse",
                            "description": "User who created this meeting note."
                          },
                          "created_time": {
                            "description": "ISO-8601 timestamp when this meeting note was created.",
                            "type": "string"
                          },
                          "has_children": {
                            "description": "Whether this block has child blocks.",
                            "type": "boolean"
                          },
                          "id": {
                            "$ref": "#/components/schemas/idResponse",
                            "description": "The ID of the meeting note block."
                          },
                          "in_trash": {
                            "description": "Whether this meeting note is in the trash.",
                            "type": "boolean"
                          },
                          "last_edited_by": {
                            "$ref": "#/components/schemas/partialUserObjectResponse",
                            "description": "User who last edited this meeting note."
                          },
                          "last_edited_time": {
                            "description": "ISO-8601 timestamp when this meeting note was last edited.",
                            "type": "string"
                          },
                          "meeting_notes": {
                            "additionalProperties": true,
                            "description": "Meeting note content fields.",
                            "properties": {
                              "calendar_event": {
                                "additionalProperties": true,
                                "description": "Calendar event metadata associated with this meeting note.",
                                "properties": {
                                  "attendees": {
                                    "description": "List of attendee user IDs.",
                                    "items": {
                                      "$ref": "#/components/schemas/idResponse"
                                    },
                                    "maxItems": 100,
                                    "type": "array"
                                  },
                                  "end_time": {
                                    "description": "ISO-8601 end time of the calendar event.",
                                    "type": "string"
                                  },
                                  "event_id": {
                                    "description": "ID of the calendar event, as returned by the calendar tools.",
                                    "type": "string"
                                  },
                                  "start_time": {
                                    "description": "ISO-8601 start time of the calendar event.",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "start_time",
                                  "end_time"
                                ],
                                "type": "object"
                              },
                              "children": {
                                "additionalProperties": true,
                                "description": "Block IDs for each tab (summary, notes, transcript).",
                                "properties": {
                                  "notes_block_id": {
                                    "$ref": "#/components/schemas/idResponse",
                                    "description": "Block ID of the meeting notes tab."
                                  },
                                  "summary_block_id": {
                                    "$ref": "#/components/schemas/idResponse",
                                    "description": "Block ID of the AI summary tab."
                                  },
                                  "transcript_block_id": {
                                    "$ref": "#/components/schemas/idResponse",
                                    "description": "Block ID of the transcript tab."
                                  }
                                },
                                "type": "object"
                              },
                              "is_full_page": {
                                "description": "Whether this is a full-page meeting note.",
                                "type": "boolean"
                              },
                              "recording": {
                                "additionalProperties": true,
                                "description": "Start and end times of the actual recording.",
                                "properties": {
                                  "end_time": {
                                    "description": "ISO-8601 timestamp when the recording ended.",
                                    "type": "string"
                                  },
                                  "start_time": {
                                    "description": "ISO-8601 timestamp when the recording started.",
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              },
                              "status": {
                                "description": "Current processing status of the meeting note transcription.",
                                "enum": [
                                  "transcription_not_started",
                                  "transcription_paused",
                                  "transcription_in_progress",
                                  "transcription_failed",
                                  "summary_in_progress",
                                  "notes_ready"
                                ],
                                "type": "string"
                              },
                              "title": {
                                "description": "Title of the meeting note as rich text.",
                                "items": {
                                  "$ref": "#/components/schemas/richTextItemResponse"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "is_full_page"
                            ],
                            "type": "object"
                          },
                          "object": {
                            "const": "block",
                            "description": "Always \"block\".",
                            "type": "string"
                          },
                          "type": {
                            "const": "meeting_notes",
                            "description": "Always \"meeting_notes\".",
                            "type": "string"
                          }
                        },
                        "required": [
                          "object",
                          "id",
                          "type",
                          "meeting_notes",
                          "created_time",
                          "last_edited_time",
                          "created_by",
                          "last_edited_by",
                          "has_children",
                          "in_trash"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    }
                  },
                  "required": [
                    "results",
                    "has_more"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Query meeting notes",
        "tags": [
          "Meeting notes"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.meetingNotes.query({\n  filter: {\n    operator: \"and\",\n    filters: [\n      {\n        property: \"title\",\n        filter: {\n          operator: \"string_contains\",\n          value: {\n            type: \"exact\",\n            value: \"Weekly sync\"\n          }\n        }\n      },\n      {\n        property: \"attendees\",\n        filter: {\n          operator: \"is_not_empty\"\n        }\n      }\n    ]\n  },\n  sort: [\n    {\n      property: \"created_time\",\n      direction: \"descending\"\n    }\n  ],\n  limit: 10\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/query-meeting-notes"
      }
    },
    "/v1/blocks/{block_id}": {
      "delete": {
        "operationId": "delete-a-block",
        "parameters": [
          {
            "in": "path",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/partialBlockObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/blockObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Delete a block",
        "tags": [
          "Blocks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.delete({\n  block_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/delete-a-block"
      },
      "get": {
        "operationId": "retrieve-a-block",
        "parameters": [
          {
            "in": "path",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/partialBlockObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/blockObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a block",
        "tags": [
          "Blocks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.retrieve({\n  block_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-a-block"
      },
      "patch": {
        "operationId": "update-a-block",
        "parameters": [
          {
            "in": "path",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "embed": {
                            "anyOf": [
                              {
                                "$ref": "#/components/schemas/updateMediaContentWithUrlAndCaptionRequest"
                              },
                              {
                                "$ref": "#/components/schemas/updateEmbedFileUploadRequest"
                              }
                            ]
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "embed",
                            "type": "string"
                          }
                        },
                        "required": [
                          "embed"
                        ],
                        "title": "Embed",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "bookmark": {
                            "$ref": "#/components/schemas/updateMediaContentWithUrlAndCaptionRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "bookmark",
                            "type": "string"
                          }
                        },
                        "required": [
                          "bookmark"
                        ],
                        "title": "Bookmark",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "image": {
                            "$ref": "#/components/schemas/updateMediaContentWithFileAndCaptionRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "image",
                            "type": "string"
                          }
                        },
                        "required": [
                          "image"
                        ],
                        "title": "Image",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "video",
                            "type": "string"
                          },
                          "video": {
                            "$ref": "#/components/schemas/updateMediaContentWithFileAndCaptionRequest"
                          }
                        },
                        "required": [
                          "video"
                        ],
                        "title": "Video",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "pdf": {
                            "$ref": "#/components/schemas/updateMediaContentWithFileAndCaptionRequest"
                          },
                          "type": {
                            "const": "pdf",
                            "type": "string"
                          }
                        },
                        "required": [
                          "pdf"
                        ],
                        "title": "Pdf",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "file": {
                            "$ref": "#/components/schemas/updateMediaContentWithFileNameAndCaptionRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "file",
                            "type": "string"
                          }
                        },
                        "required": [
                          "file"
                        ],
                        "title": "File",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "audio": {
                            "$ref": "#/components/schemas/updateMediaContentWithFileAndCaptionRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "audio",
                            "type": "string"
                          }
                        },
                        "required": [
                          "audio"
                        ],
                        "title": "Audio",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "code": {
                            "additionalProperties": false,
                            "properties": {
                              "caption": {
                                "items": {
                                  "$ref": "#/components/schemas/richTextItemRequest"
                                },
                                "maxItems": 100,
                                "type": "array"
                              },
                              "language": {
                                "$ref": "#/components/schemas/languageRequest"
                              },
                              "rich_text": {
                                "items": {
                                  "$ref": "#/components/schemas/richTextItemRequest"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "type": "object"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "code",
                            "type": "string"
                          }
                        },
                        "required": [
                          "code"
                        ],
                        "title": "Code",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "equation": {
                            "$ref": "#/components/schemas/contentWithExpressionRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "equation",
                            "type": "string"
                          }
                        },
                        "required": [
                          "equation"
                        ],
                        "title": "Equation",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "divider": {
                            "$ref": "#/components/schemas/emptyObject"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "divider",
                            "type": "string"
                          }
                        },
                        "required": [
                          "divider"
                        ],
                        "title": "Divider",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "breadcrumb": {
                            "$ref": "#/components/schemas/emptyObject"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "breadcrumb",
                            "type": "string"
                          }
                        },
                        "required": [
                          "breadcrumb"
                        ],
                        "title": "Breadcrumb",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "tab": {
                            "$ref": "#/components/schemas/emptyObject"
                          },
                          "type": {
                            "const": "tab",
                            "type": "string"
                          }
                        },
                        "required": [
                          "tab"
                        ],
                        "title": "Tab",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "table_of_contents": {
                            "additionalProperties": false,
                            "properties": {
                              "color": {
                                "$ref": "#/components/schemas/apiColor"
                              }
                            },
                            "type": "object"
                          },
                          "type": {
                            "const": "table_of_contents",
                            "type": "string"
                          }
                        },
                        "required": [
                          "table_of_contents"
                        ],
                        "title": "Table Of Contents",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "link_to_page": {
                            "anyOf": [
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "page_id": {
                                    "$ref": "#/components/schemas/idRequest"
                                  },
                                  "type": {
                                    "const": "page_id",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "page_id"
                                ],
                                "title": "Page Id",
                                "type": "object"
                              },
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "database_id": {
                                    "$ref": "#/components/schemas/idRequest"
                                  },
                                  "type": {
                                    "const": "database_id",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "database_id"
                                ],
                                "title": "Database Id",
                                "type": "object"
                              },
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "comment_id": {
                                    "$ref": "#/components/schemas/idRequest"
                                  },
                                  "type": {
                                    "const": "comment_id",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "comment_id"
                                ],
                                "title": "Comment Id",
                                "type": "object"
                              }
                            ]
                          },
                          "type": {
                            "const": "link_to_page",
                            "type": "string"
                          }
                        },
                        "required": [
                          "link_to_page"
                        ],
                        "title": "Link To Page",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "table_row": {
                            "$ref": "#/components/schemas/contentWithTableRowRequest"
                          },
                          "type": {
                            "const": "table_row",
                            "type": "string"
                          }
                        },
                        "required": [
                          "table_row"
                        ],
                        "title": "Table Row",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "heading_1": {
                            "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "heading_1",
                            "type": "string"
                          }
                        },
                        "required": [
                          "heading_1"
                        ],
                        "title": "Heading 1",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "heading_2": {
                            "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "heading_2",
                            "type": "string"
                          }
                        },
                        "required": [
                          "heading_2"
                        ],
                        "title": "Heading 2",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "heading_3": {
                            "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "heading_3",
                            "type": "string"
                          }
                        },
                        "required": [
                          "heading_3"
                        ],
                        "title": "Heading 3",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "heading_4": {
                            "$ref": "#/components/schemas/headerContentWithRichTextAndColorRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "heading_4",
                            "type": "string"
                          }
                        },
                        "required": [
                          "heading_4"
                        ],
                        "title": "Heading 4",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "paragraph": {
                            "$ref": "#/components/schemas/contentWithRichTextColorAndIconUpdateRequest"
                          },
                          "type": {
                            "const": "paragraph",
                            "type": "string"
                          }
                        },
                        "required": [
                          "paragraph"
                        ],
                        "title": "Paragraph",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "bulleted_list_item": {
                            "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "bulleted_list_item",
                            "type": "string"
                          }
                        },
                        "required": [
                          "bulleted_list_item"
                        ],
                        "title": "Bulleted List Item",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "numbered_list_item": {
                            "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
                          },
                          "type": {
                            "const": "numbered_list_item",
                            "type": "string"
                          }
                        },
                        "required": [
                          "numbered_list_item"
                        ],
                        "title": "Numbered List Item",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "quote": {
                            "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
                          },
                          "type": {
                            "const": "quote",
                            "type": "string"
                          }
                        },
                        "required": [
                          "quote"
                        ],
                        "title": "Quote",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "to_do": {
                            "properties": {
                              "checked": {
                                "type": "boolean"
                              },
                              "color": {
                                "$ref": "#/components/schemas/apiColor"
                              },
                              "rich_text": {
                                "items": {
                                  "$ref": "#/components/schemas/richTextItemRequest"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "type": "object"
                          },
                          "type": {
                            "const": "to_do",
                            "type": "string"
                          }
                        },
                        "required": [
                          "to_do"
                        ],
                        "title": "To Do",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "toggle": {
                            "$ref": "#/components/schemas/contentWithRichTextAndColorRequest"
                          },
                          "type": {
                            "const": "toggle",
                            "type": "string"
                          }
                        },
                        "required": [
                          "toggle"
                        ],
                        "title": "Toggle",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "template": {
                            "$ref": "#/components/schemas/contentWithRichTextRequest"
                          },
                          "type": {
                            "const": "template",
                            "type": "string"
                          }
                        },
                        "required": [
                          "template"
                        ],
                        "title": "Template",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "callout": {
                            "properties": {
                              "color": {
                                "$ref": "#/components/schemas/apiColor"
                              },
                              "icon": {
                                "$ref": "#/components/schemas/pageIconRequest"
                              },
                              "rich_text": {
                                "items": {
                                  "$ref": "#/components/schemas/richTextItemRequest"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "type": "object"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "callout",
                            "type": "string"
                          }
                        },
                        "required": [
                          "callout"
                        ],
                        "title": "Callout",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "synced_block": {
                            "additionalProperties": false,
                            "properties": {
                              "synced_from": {
                                "additionalProperties": false,
                                "properties": {
                                  "block_id": {
                                    "$ref": "#/components/schemas/idRequest"
                                  },
                                  "type": {
                                    "const": "block_id",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "block_id"
                                ],
                                "title": "Block Id",
                                "type": [
                                  "object",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "synced_from"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "const": "synced_block",
                            "type": "string"
                          }
                        },
                        "required": [
                          "synced_block"
                        ],
                        "title": "Synced Block",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "table": {
                            "additionalProperties": false,
                            "properties": {
                              "has_column_header": {
                                "type": "boolean"
                              },
                              "has_row_header": {
                                "type": "boolean"
                              }
                            },
                            "type": "object"
                          },
                          "type": {
                            "const": "table",
                            "type": "string"
                          }
                        },
                        "required": [
                          "table"
                        ],
                        "title": "Table",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "column": {
                            "additionalProperties": false,
                            "properties": {
                              "width_ratio": {
                                "description": "Ratio between 0 and 1 of the width of this column relative to all columns in the list. If not provided, uses an equal width.",
                                "examples": [
                                  0.5
                                ],
                                "exclusiveMaximum": 1,
                                "exclusiveMinimum": 0,
                                "type": "number"
                              }
                            },
                            "type": "object"
                          },
                          "in_trash": {
                            "type": "boolean"
                          },
                          "type": {
                            "const": "column",
                            "type": "string"
                          }
                        },
                        "required": [
                          "column"
                        ],
                        "title": "Column",
                        "type": "object"
                      }
                    ]
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "in_trash": {
                        "type": "boolean"
                      }
                    },
                    "type": "object"
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/partialBlockObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/blockObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update a block",
        "tags": [
          "Blocks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.update({\n  block_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\",\n  paragraph: {\n    rich_text: [{ text: { content: \"Updated paragraph text\" } }]\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/update-a-block"
      }
    },
    "/v1/blocks/{block_id}/children": {
      "get": {
        "operationId": "get-block-children",
        "parameters": [
          {
            "in": "path",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "block": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "object": {
                      "const": "list",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/partialBlockObjectResponse"
                          },
                          {
                            "$ref": "#/components/schemas/blockObjectResponse"
                          }
                        ]
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "block",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "block",
                    "object",
                    "next_cursor",
                    "has_more",
                    "results"
                  ],
                  "title": "Block",
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve block children",
        "tags": [
          "Blocks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.children.list({\n  block_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\",\n  start_cursor: undefined,\n  page_size: 50\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/get-block-children"
      },
      "patch": {
        "operationId": "patch-block-children",
        "parameters": [
          {
            "in": "path",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "notifications": {
                    "$ref": "#/components/schemas/pageWriteNotificationsSchema"
                  },
                  "position": {
                    "$ref": "#/components/schemas/contentPositionSchema"
                  }
                },
                "required": [
                  "children"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "block": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "object": {
                      "const": "list",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/partialBlockObjectResponse"
                          },
                          {
                            "$ref": "#/components/schemas/blockObjectResponse"
                          }
                        ]
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "block",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "block",
                    "object",
                    "next_cursor",
                    "has_more",
                    "results"
                  ],
                  "title": "Block",
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Append block children",
        "tags": [
          "Blocks"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.blocks.children.append({\n  block_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\",\n  children: [\n    {\n      type: \"paragraph\",\n      paragraph: {\n        rich_text: [{ text: { content: \"Hello, world!\" } }]\n      }\n    }\n  ]\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/patch-block-children"
      }
    },
    "/v1/comments": {
      "get": {
        "operationId": "list-comments",
        "parameters": [
          {
            "in": "query",
            "name": "block_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Identifier for a Notion block or page."
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items from the full list desired in the response. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "comment": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "request_status": {
                      "$ref": "#/components/schemas/requestStatusResponse"
                    },
                    "results": {
                      "items": {
                        "$ref": "#/components/schemas/commentObjectResponse"
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "comment",
                      "description": "Always `comment`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "next_cursor",
                    "has_more",
                    "results",
                    "type",
                    "comment"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List comments",
        "tags": [
          "Comments"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.comments.list({\n  block_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\",\n  start_cursor: undefined,\n  page_size: 50\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-comments"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/list-comments",
        "x-notion-sdk-method": "comments.list"
      },
      "post": {
        "operationId": "create-a-comment",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "properties": {
                      "attachments": {
                        "description": "An array of files to attach to the comment. Maximum of 3 allowed.",
                        "items": {
                          "properties": {
                            "file_upload_id": {
                              "description": "ID of a FileUpload object that has the status `uploaded`.",
                              "type": "string"
                            },
                            "type": {
                              "const": "file_upload",
                              "description": "Always `file_upload`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "file_upload_id"
                          ],
                          "type": "object"
                        },
                        "maxItems": 3,
                        "type": "array"
                      },
                      "display_name": {
                        "description": "Display name for the comment.",
                        "oneOf": [
                          {
                            "properties": {
                              "type": {
                                "const": "integration",
                                "description": "Always `integration`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type"
                            ],
                            "title": "Integration",
                            "type": "object"
                          },
                          {
                            "properties": {
                              "type": {
                                "const": "user",
                                "description": "Always `user`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type"
                            ],
                            "title": "User",
                            "type": "object"
                          },
                          {
                            "properties": {
                              "custom": {
                                "properties": {
                                  "name": {
                                    "description": "The custom display name to use",
                                    "minLength": 1,
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "name"
                                ],
                                "type": "object"
                              },
                              "type": {
                                "const": "custom",
                                "description": "Always `custom`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "custom"
                            ],
                            "title": "Custom",
                            "type": "object"
                          }
                        ]
                      },
                      "markdown_version": {
                        "description": "The Markdown syntax to use. `v2` is [Notion-flavored Markdown](/guides/data-apis/notion-flavored-markdown) and is recommended. `v1` is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects `v1` with a `400` `validation_error`.",
                        "enum": [
                          "v1",
                          "v2"
                        ],
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  {
                    "oneOf": [
                      {
                        "properties": {
                          "parent": {
                            "description": "The parent of the comment. This can be a page or a block.",
                            "oneOf": [
                              {
                                "properties": {
                                  "page_id": {
                                    "$ref": "#/components/schemas/idRequest",
                                    "description": "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105"
                                  },
                                  "type": {
                                    "const": "page_id",
                                    "description": "Always `page_id`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "page_id"
                                ],
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "block_id": {
                                    "$ref": "#/components/schemas/idRequest",
                                    "description": "The ID of the parent block (with or without dashes), for example, 195de9221179449fab8075a27c979105"
                                  },
                                  "type": {
                                    "const": "block_id",
                                    "description": "Always `block_id`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "block_id"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "rich_text": {
                            "description": "An array of rich text objects that represent the content of the comment.",
                            "items": {
                              "$ref": "#/components/schemas/richTextItemRequest"
                            },
                            "maxItems": 100,
                            "type": "array"
                          }
                        },
                        "required": [
                          "parent",
                          "rich_text"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "markdown": {
                            "description": "The content of the comment as a Markdown string. Comment Markdown supports inline formatting only (bold, italic, strikethrough, code, links), inline equations ($expression$), and mentions. Block-level Markdown such as fenced code blocks, headings, lists, tables, and blockquotes does not render as structured blocks in comments.",
                            "type": "string"
                          },
                          "parent": {
                            "description": "The parent of the comment. This can be a page or a block.",
                            "oneOf": [
                              {
                                "properties": {
                                  "page_id": {
                                    "$ref": "#/components/schemas/idRequest",
                                    "description": "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105"
                                  },
                                  "type": {
                                    "const": "page_id",
                                    "description": "Always `page_id`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "page_id"
                                ],
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "block_id": {
                                    "$ref": "#/components/schemas/idRequest",
                                    "description": "The ID of the parent block (with or without dashes), for example, 195de9221179449fab8075a27c979105"
                                  },
                                  "type": {
                                    "const": "block_id",
                                    "description": "Always `block_id`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "block_id"
                                ],
                                "type": "object"
                              }
                            ]
                          }
                        },
                        "required": [
                          "parent",
                          "markdown"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "discussion_id": {
                            "$ref": "#/components/schemas/idRequest",
                            "description": "The ID of the discussion to comment on."
                          },
                          "rich_text": {
                            "description": "An array of rich text objects that represent the content of the comment.",
                            "items": {
                              "$ref": "#/components/schemas/richTextItemRequest"
                            },
                            "maxItems": 100,
                            "type": "array"
                          }
                        },
                        "required": [
                          "discussion_id",
                          "rich_text"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "discussion_id": {
                            "$ref": "#/components/schemas/idRequest",
                            "description": "The ID of the discussion to comment on."
                          },
                          "markdown": {
                            "description": "The content of the comment as a Markdown string. Comment Markdown supports inline formatting only (bold, italic, strikethrough, code, links), inline equations ($expression$), and mentions. Block-level Markdown such as fenced code blocks, headings, lists, tables, and blockquotes does not render as structured blocks in comments.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "discussion_id",
                          "markdown"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialCommentObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/commentObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a comment",
        "tags": [
          "Comments"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.comments.create({\n  parent: { page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\" },\n  rich_text: [{ text: { content: \"This is a comment\" } }]\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-comments"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-a-comment",
        "x-notion-sdk-method": "comments.create"
      }
    },
    "/v1/comments/{comment_id}": {
      "delete": {
        "operationId": "delete-a-comment",
        "parameters": [
          {
            "in": "path",
            "name": "comment_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the comment to delete."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialCommentObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/commentObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Delete a comment",
        "tags": [
          "Comments"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.comments.delete({\n  comment_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/delete-a-comment"
      },
      "get": {
        "operationId": "retrieve-comment",
        "parameters": [
          {
            "in": "path",
            "name": "comment_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the comment to retrieve."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialCommentObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/commentObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a comment",
        "tags": [
          "Comments"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.comments.retrieve({\n  comment_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-comments"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-comment"
      },
      "patch": {
        "operationId": "update-a-comment",
        "parameters": [
          {
            "in": "path",
            "name": "comment_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the comment to update."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "properties": {
                      "markdown_version": {
                        "description": "The Markdown syntax to use. `v2` is [Notion-flavored Markdown](/guides/data-apis/notion-flavored-markdown) and is recommended. `v1` is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects `v1` with a `400` `validation_error`.",
                        "enum": [
                          "v1",
                          "v2"
                        ],
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  {
                    "oneOf": [
                      {
                        "properties": {
                          "rich_text": {
                            "description": "An array of rich text objects that represent the updated content of the comment.",
                            "items": {
                              "$ref": "#/components/schemas/richTextItemRequest"
                            },
                            "maxItems": 100,
                            "type": "array"
                          }
                        },
                        "required": [
                          "rich_text"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "markdown": {
                            "description": "The updated content of the comment as a Markdown string. Comment Markdown supports inline formatting only (bold, italic, strikethrough, code, links), inline equations ($expression$), and mentions. Block-level Markdown such as fenced code blocks, headings, lists, tables, and blockquotes does not render as structured blocks in comments.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "markdown"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialCommentObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/commentObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update a comment",
        "tags": [
          "Comments"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.comments.update({\n  comment_id: \"c02fc1d3-db8b-45c5-a222-27595b15aea7\",\n  rich_text: [{ text: { content: \"Updated comment text\" } }]\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/update-a-comment"
      }
    },
    "/v1/custom_emojis": {
      "get": {
        "operationId": "list-custom-emojis",
        "parameters": [
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items from the full list desired in the response. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "name",
            "schema": {
              "description": "If supplied, filters custom emojis by exact name match. Useful for resolving a custom emoji name to its ID.",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "description": "Whether there are more results available.",
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "description": "The cursor to use for the next page of results, or null if there are no more results.",
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "results": {
                      "description": "The list of custom emojis.",
                      "items": {
                        "$ref": "#/components/schemas/customEmojiResponse"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "type": {
                      "const": "custom_emoji",
                      "description": "Always `custom_emoji`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "type",
                    "results",
                    "has_more",
                    "next_cursor"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List custom emojis",
        "tags": [
          "Custom emojis"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\nimport { collectPaginatedAPI } from \"@notionhq/client\"\n\nconst notion = new Client()\n\n// Single page\nconst response = await notion.customEmojis.list()\n\n// All pages with pagination helper\nconst allEmojis = await collectPaginatedAPI(\n  notion.customEmojis.list,\n  {}\n)"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/list-custom-emojis"
      }
    },
    "/v1/data_sources": {
      "post": {
        "operationId": "create-a-database",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "icon": {
                    "description": "Page icon.",
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/pageIconRequest"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "parent": {
                    "$ref": "#/components/schemas/parentOfDataSourceRequest",
                    "description": "An object specifying the parent of the new data source to be created."
                  },
                  "properties": {
                    "additionalProperties": {
                      "$ref": "#/components/schemas/propertyConfigurationRequest"
                    },
                    "description": "Property schema of data source.",
                    "type": "object"
                  },
                  "title": {
                    "description": "Title of data source as it appears in Notion.",
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent",
                  "properties"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDataSourceObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/dataSourceObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a data source",
        "tags": [
          "Data sources"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.dataSources.create({\n  parent: {\n    database_id: \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n  },\n  title: [{ text: { content: \"My Data Source\" } }],\n  properties: {\n    Name: { title: {} },\n    Status: {\n      select: {\n        options: [\n          { name: \"To Do\", color: \"red\" },\n          { name: \"Done\", color: \"green\" }\n        ]\n      }\n    }\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-a-database"
      }
    },
    "/v1/data_sources/{data_source_id}": {
      "get": {
        "operationId": "retrieve-a-data-source",
        "parameters": [
          {
            "in": "path",
            "name": "data_source_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion data source."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDataSourceObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/dataSourceObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a data source",
        "tags": [
          "Data sources"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.dataSources.retrieve({\n  data_source_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-a-data-source"
      }
    },
    "/v1/data_sources/{data_source_id}/query": {
      "post": {
        "operationId": "post-database-query",
        "parameters": [
          {
            "in": "path",
            "name": "data_source_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          },
          {
            "in": "query",
            "name": "filter_properties",
            "schema": {
              "description": "Property names or IDs to include in each page's `properties` object. Other properties are left out. Repeat the parameter to pass more than one value, for example `filter_properties=title&filter_properties=Status`. Pages that aren't in a data source always return only `title`.",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "filter": {
                    "$ref": "#/components/schemas/viewFilterRequest"
                  },
                  "is_archived": {
                    "description": "Whether to return archived pages. When omitted or false, returns non-archived pages. When true, returns archived pages.",
                    "type": "boolean"
                  },
                  "page_size": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "result_type": {
                    "description": "Optionally filter the results to only include pages or data sources. Regular, non-wiki databases only support page children. The default behavior is no result type filtering, in other words, returning both pages and data sources for wikis.",
                    "enum": [
                      "page",
                      "data_source"
                    ],
                    "type": "string"
                  },
                  "sorts": {
                    "items": {
                      "$ref": "#/components/schemas/viewSortRequest"
                    },
                    "type": "array"
                  },
                  "start_cursor": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/pageOrDataSourceListResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Query a data source",
        "tags": [
          "Data sources"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.dataSources.query({\n  data_source_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\",\n  filter: {\n    property: \"Status\",\n    select: { equals: \"Done\" }\n  },\n  sorts: [\n    {\n      property: \"Created\",\n      direction: \"descending\"\n    }\n  ]\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/post-database-query"
      }
    },
    "/v1/data_sources/{data_source_id}/templates": {
      "get": {
        "operationId": "list-data-source-templates",
        "parameters": [
          {
            "in": "path",
            "name": "data_source_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion data source."
            }
          },
          {
            "in": "query",
            "name": "name",
            "schema": {
              "description": "Filter templates by name (case-insensitive substring match).",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items from the full list desired in the response. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "description": "Whether there are more templates available beyond this page.",
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "description": "Cursor to use for the next page of results. Null if there are no more results.",
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "templates": {
                      "description": "Array of templates available in this data source.",
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "$ref": "#/components/schemas/idResponse",
                            "description": "ID of the template page."
                          },
                          "is_default": {
                            "description": "Whether this template is the default template for the data source.",
                            "type": "boolean"
                          },
                          "name": {
                            "description": "Name of the template.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "is_default"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    }
                  },
                  "required": [
                    "templates",
                    "has_more",
                    "next_cursor"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List templates in a data source",
        "tags": [
          "Data sources"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.dataSources.listTemplates({\n  data_source_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/list-data-source-templates"
      }
    },
    "/v1/databases": {
      "post": {
        "operationId": "create-database",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "cover": {
                    "$ref": "#/components/schemas/pageCoverRequest",
                    "description": "The cover image for the database."
                  },
                  "database_type": {
                    "description": "Create a typed database with Notion's canonical schema. One of `tasks`, `projects`, or `skills`. Cannot be combined with `initial_data_source`. When `title` is omitted, the database is named after the type.",
                    "enum": [
                      "tasks",
                      "projects",
                      "skills"
                    ],
                    "type": "string"
                  },
                  "description": {
                    "description": "The description of the database.",
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest",
                    "description": "The icon for the database."
                  },
                  "initial_data_source": {
                    "$ref": "#/components/schemas/initialDataSourceRequest",
                    "description": "Initial data source configuration for the database."
                  },
                  "is_inline": {
                    "description": "Whether the database should be displayed inline in the parent page. Defaults to false.",
                    "type": "boolean"
                  },
                  "parent": {
                    "allOf": [
                      {
                        "properties": {
                          "type": {
                            "description": "The type of parent.",
                            "enum": [
                              "page_id",
                              "workspace"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      {
                        "oneOf": [
                          {
                            "properties": {
                              "page_id": {
                                "$ref": "#/components/schemas/idRequest"
                              },
                              "type": {
                                "const": "page_id",
                                "description": "Always `page_id`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "page_id"
                            ],
                            "title": "Page Id",
                            "type": "object"
                          },
                          {
                            "properties": {
                              "type": {
                                "const": "workspace",
                                "description": "Always `workspace`",
                                "type": "string"
                              },
                              "workspace": {
                                "const": true,
                                "description": "Always `true`",
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "workspace"
                            ],
                            "title": "Workspace",
                            "type": "object"
                          }
                        ]
                      }
                    ],
                    "description": "The parent page or workspace where the database will be created."
                  },
                  "show_data_source_title": {
                    "description": "Whether to show the data source title above the database's views. Matches the Show data source title toggle in the Notion app. Defaults to true. Full-page databases with one data source don't show this title.",
                    "type": "boolean"
                  },
                  "title": {
                    "description": "The title of the database.",
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "required": [
                  "parent"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDatabaseObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/databaseObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a database",
        "tags": [
          "Databases"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.databases.create({\n  parent: {\n    type: \"page_id\",\n    page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\"\n  },\n  title: [{ text: { content: \"My Database\" } }]\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-database"
      }
    },
    "/v1/databases/{database_id}": {
      "get": {
        "operationId": "retrieve-database",
        "parameters": [
          {
            "in": "path",
            "name": "database_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion database, a container for one or more data sources."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDatabaseObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/databaseObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a database",
        "tags": [
          "Databases"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.databases.retrieve({\n  database_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-database"
      },
      "patch": {
        "operationId": "update-database",
        "parameters": [
          {
            "in": "path",
            "name": "database_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion database, a container for one or more data sources."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "cover": {
                    "$ref": "#/components/schemas/pageCoverRequest",
                    "description": "The updated cover image for the database, if any. If not provided, the cover will not be updated."
                  },
                  "description": {
                    "description": "The updated description of the database, if any. If not provided, the description will not be updated.",
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "icon": {
                    "$ref": "#/components/schemas/pageIconRequest",
                    "description": "The updated icon for the database, if any. If not provided, the icon will not be updated."
                  },
                  "in_trash": {
                    "description": "Whether the database should be moved to or from the trash. If not provided, the trash status will not be updated.",
                    "type": "boolean"
                  },
                  "is_inline": {
                    "description": "Whether the database should be displayed inline in the parent page. If not provided, the inline status will not be updated.",
                    "type": "boolean"
                  },
                  "is_locked": {
                    "description": "Whether the database should be locked from editing in the Notion app UI. If not provided, the locked state will not be updated.",
                    "type": "boolean"
                  },
                  "parent": {
                    "allOf": [
                      {
                        "properties": {
                          "type": {
                            "description": "The type of parent.",
                            "enum": [
                              "page_id",
                              "workspace"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      {
                        "oneOf": [
                          {
                            "properties": {
                              "page_id": {
                                "$ref": "#/components/schemas/idRequest"
                              },
                              "type": {
                                "const": "page_id",
                                "description": "Always `page_id`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "type",
                              "page_id"
                            ],
                            "title": "Page Id",
                            "type": "object"
                          },
                          {
                            "properties": {
                              "type": {
                                "const": "workspace",
                                "description": "Always `workspace`",
                                "type": "string"
                              },
                              "workspace": {
                                "const": true,
                                "description": "Always `true`",
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "workspace"
                            ],
                            "title": "Workspace",
                            "type": "object"
                          }
                        ]
                      }
                    ],
                    "description": "The parent page or workspace to move the database to. If not provided, the database will not be moved."
                  },
                  "show_data_source_title": {
                    "description": "Whether to show the data source title above the database's views. Matches the Show data source title toggle in the Notion app. If not provided, the setting will not be updated.",
                    "type": "boolean"
                  },
                  "title": {
                    "description": "The updated title of the database, if any. If not provided, the title will not be updated.",
                    "items": {
                      "$ref": "#/components/schemas/richTextItemRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDatabaseObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/databaseObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update a database",
        "tags": [
          "Databases"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.databases.update({\n  database_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\",\n  title: [{ text: { content: \"Updated Database Title\" } }]\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/update-database"
      }
    },
    "/v1/file_uploads": {
      "get": {
        "operationId": "list-file-uploads",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "schema": {
              "description": "If supplied, the endpoint will return file uploads with the specified status.",
              "enum": [
                "pending",
                "uploaded",
                "expired",
                "failed"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items from the full list desired in the response. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "file_upload": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "request_status": {
                      "$ref": "#/components/schemas/requestStatusResponse"
                    },
                    "results": {
                      "items": {
                        "$ref": "#/components/schemas/fileUploadObjectResponse"
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "file_upload",
                      "description": "Always `file_upload`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "next_cursor",
                    "has_more",
                    "results",
                    "type",
                    "file_upload"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List file uploads",
        "tags": [
          "File uploads"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.fileUploads.list({\n  start_cursor: undefined,\n  page_size: 50\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-files-and-media"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/list-file-uploads"
      },
      "post": {
        "operationId": "create-file",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "content_type": {
                    "description": "The MIME type. It must match the uploaded file and any filename extension.",
                    "examples": [
                      "application/pdf"
                    ],
                    "type": "string"
                  },
                  "external_url": {
                    "description": "A public HTTPS URL to import. Required only for external_url uploads.",
                    "type": "string"
                  },
                  "filename": {
                    "description": "The filename. Required for multi_part and external_url uploads. Include an extension or provide content_type so one can be inferred.",
                    "examples": [
                      "business_summary.pdf"
                    ],
                    "type": "string"
                  },
                  "mode": {
                    "description": "How the file is sent. Defaults to single_part. Use multi_part for files larger than 20 MiB or external_url for a temporary public HTTPS URL.",
                    "enum": [
                      "single_part",
                      "multi_part",
                      "external_url"
                    ],
                    "type": "string"
                  },
                  "number_of_parts": {
                    "description": "The number of parts in a multi_part upload. Required only for multi_part uploads. This must match the number of uploaded parts and the final part_number sent.",
                    "maximum": 10000,
                    "minimum": 1,
                    "type": "integer"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fileUploadObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a file upload",
        "tags": [
          "File uploads"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.fileUploads.create({\n  mode: \"single_part\",\n  filename: \"document.pdf\",\n  content_type: \"application/pdf\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-files-and-media",
          "https://developers.notion.com/guides/data-apis/uploading-small-files"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-file"
      }
    },
    "/v1/file_uploads/{file_upload_id}": {
      "get": {
        "operationId": "retrieve-file-upload",
        "parameters": [
          {
            "in": "path",
            "name": "file_upload_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Identifier for a Notion file upload object."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fileUploadObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a file upload",
        "tags": [
          "File uploads"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.fileUploads.retrieve({\n  file_upload_id: \"a02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-files-and-media",
          "https://developers.notion.com/guides/data-apis/retrieving-files"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-file-upload"
      }
    },
    "/v1/file_uploads/{file_upload_id}/complete": {
      "post": {
        "operationId": "complete-file-upload",
        "parameters": [
          {
            "in": "path",
            "name": "file_upload_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Identifier for a Notion file upload object."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fileUploadObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Complete a multi-part file upload",
        "tags": [
          "File uploads"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.fileUploads.complete({\n  file_upload_id: \"a02fc1d3-db8b-45c5-a222-27595b15aea7\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-files-and-media",
          "https://developers.notion.com/guides/data-apis/sending-larger-files"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/complete-file-upload"
      }
    },
    "/v1/file_uploads/{file_upload_id}/send": {
      "post": {
        "operationId": "upload-file",
        "parameters": [
          {
            "in": "path",
            "name": "file_upload_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "Identifier for a Notion file upload object."
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "properties": {
                  "file": {
                    "description": "The raw binary file contents to upload.",
                    "format": "binary",
                    "type": "string"
                  },
                  "part_number": {
                    "description": "When uploading files greater than 20MB in parts, this is the current part number. Must be an integer between 1 and 1,000.",
                    "type": "string"
                  }
                },
                "required": [
                  "file"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fileUploadObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Upload a file",
        "tags": [
          "File uploads"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nimport { readFile } from \"fs/promises\"\nimport { basename } from \"path\"\n\nconst filePath = \"./document.pdf\"\n\nconst response = await notion.fileUploads.send({\n  file_upload_id: \"a02fc1d3-db8b-45c5-a222-27595b15aea7\",\n  file: {\n    filename: basename(filePath),\n    data: new Blob([await readFile(filePath)], {\n      type: \"application/pdf\"\n    })\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-files-and-media",
          "https://developers.notion.com/guides/data-apis/sending-larger-files"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/upload-file"
      }
    },
    "/v1/pages": {
      "post": {
        "operationId": "post-page",
        "parameters": [
          {
            "in": "query",
            "name": "filter_properties",
            "schema": {
              "description": "Property names or IDs to include in each page's `properties` object. Other properties are left out. Repeat the parameter to pass more than one value, for example `filter_properties=title&filter_properties=Status`. Pages that aren't in a data source always return only `title`.",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "allow_async": {
                    "description": "Set to true to receive an async_task response for markdown page creation. Only supported when markdown is provided.",
                    "type": "boolean"
                  },
                  "children": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "content": {
                    "items": {
                      "$ref": "#/components/schemas/blockObjectRequest"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  "cover": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/pageCoverRequest"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "icon": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/pageIconRequest"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "markdown": {
                    "description": "Page content as Markdown, in the syntax set by `markdown_version`: Notion-flavored Markdown (`v2`, recommended) or enhanced markdown (`v1`, deprecated, the default on current Notion-Versions). Mutually exclusive with content/children.",
                    "type": "string"
                  },
                  "markdown_version": {
                    "description": "The Markdown syntax to use. `v2` is [Notion-flavored Markdown](/guides/data-apis/notion-flavored-markdown) and is recommended. `v1` is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects `v1` with a `400` `validation_error`.",
                    "enum": [
                      "v1",
                      "v2"
                    ],
                    "type": "string"
                  },
                  "notifications": {
                    "$ref": "#/components/schemas/pageWriteNotificationsSchema"
                  },
                  "parent": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "page_id": {
                            "$ref": "#/components/schemas/idRequest"
                          },
                          "type": {
                            "const": "page_id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "page_id"
                        ],
                        "title": "Page Id",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "database_id": {
                            "$ref": "#/components/schemas/idRequest"
                          },
                          "type": {
                            "const": "database_id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "database_id"
                        ],
                        "title": "Database Id",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "data_source_id": {
                            "$ref": "#/components/schemas/idRequest"
                          },
                          "type": {
                            "const": "data_source_id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "data_source_id"
                        ],
                        "title": "Data Source Id",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "const": "workspace",
                            "type": "string"
                          },
                          "workspace": {
                            "const": true,
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "workspace"
                        ],
                        "title": "Workspace",
                        "type": "object"
                      }
                    ]
                  },
                  "position": {
                    "$ref": "#/components/schemas/pagePositionSchema"
                  },
                  "properties": {
                    "$ref": "#/components/schemas/pagePropertiesRequest"
                  },
                  "template": {
                    "anyOf": [
                      {
                        "properties": {
                          "type": {
                            "const": "none",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "timezone": {
                            "$ref": "#/components/schemas/templateTimezone"
                          },
                          "type": {
                            "const": "default",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "template_id": {
                            "$ref": "#/components/schemas/idRequest"
                          },
                          "timezone": {
                            "$ref": "#/components/schemas/templateTimezone"
                          },
                          "type": {
                            "const": "template_id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "template_id"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/pageObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/partialPageObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "created_time": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "id": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "object": {
                      "const": "async_task",
                      "type": "string"
                    },
                    "operation": {
                      "anyOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "$ref": "#/components/schemas/asyncTaskRestOperationName"
                            },
                            "surface": {
                              "const": "rest",
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "$ref": "#/components/schemas/asyncTaskMcpOperationName"
                            },
                            "surface": {
                              "const": "mcp",
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "poll_after_seconds": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "status": {
                      "$ref": "#/components/schemas/nonTerminalAsyncTaskStatus"
                    },
                    "status_url": {
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "status",
                    "status_url",
                    "created_time",
                    "poll_after_seconds",
                    "operation"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a page",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.create({\n  parent: {\n    data_source_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n  },\n  properties: {\n    Name: {\n      title: [{ text: { content: \"New Page Title\" } }]\n    }\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content",
          "https://developers.notion.com/guides/data-apis/creating-pages-from-templates"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/post-page"
      }
    },
    "/v1/pages/{page_id}": {
      "get": {
        "operationId": "retrieve-a-page",
        "parameters": [
          {
            "in": "path",
            "name": "page_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the page to retrieve."
            }
          },
          {
            "in": "query",
            "name": "filter_properties",
            "schema": {
              "description": "Property names or IDs to include in each page's `properties` object. Other properties are left out. Repeat the parameter to pass more than one value, for example `filter_properties=title&filter_properties=Status`. Pages that aren't in a data source always return only `title`.",
              "items": {
                "type": "string"
              },
              "maxItems": 100,
              "type": "array"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialPageObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/pageObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a page",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.retrieve({\n  page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-a-page"
      },
      "patch": {
        "operationId": "patch-page",
        "parameters": [
          {
            "in": "path",
            "name": "page_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest"
            }
          },
          {
            "in": "query",
            "name": "filter_properties",
            "schema": {
              "description": "Property names or IDs to include in each page's `properties` object. Other properties are left out. Repeat the parameter to pass more than one value, for example `filter_properties=title&filter_properties=Status`. Pages that aren't in a data source always return only `title`.",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "cover": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/pageCoverRequest"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "erase_content": {
                    "description": "Whether to erase all existing content from the page. When used with a template, the template content replaces the existing content. When used without a template, simply clears the page content.",
                    "type": "boolean"
                  },
                  "icon": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/pageIconRequest"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "in_trash": {
                    "type": "boolean"
                  },
                  "is_archived": {
                    "type": "boolean"
                  },
                  "is_locked": {
                    "description": "Whether the page should be locked from editing in the Notion app UI. If not provided, the locked state will not be updated.",
                    "type": "boolean"
                  },
                  "notifications": {
                    "$ref": "#/components/schemas/pageWriteNotificationsSchema"
                  },
                  "properties": {
                    "$ref": "#/components/schemas/pagePropertiesRequest"
                  },
                  "template": {
                    "anyOf": [
                      {
                        "properties": {
                          "timezone": {
                            "$ref": "#/components/schemas/templateTimezone"
                          },
                          "type": {
                            "const": "default",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "template_id": {
                            "$ref": "#/components/schemas/idRequest"
                          },
                          "timezone": {
                            "$ref": "#/components/schemas/templateTimezone"
                          },
                          "type": {
                            "const": "template_id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "template_id"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/pageObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/partialPageObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update page",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.update({\n  page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\",\n  properties: {\n    Name: {\n      title: [{ text: { content: \"Updated Title\" } }]\n    }\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/patch-page"
      }
    },
    "/v1/pages/{page_id}/markdown": {
      "get": {
        "operationId": "retrieve-page-markdown",
        "parameters": [
          {
            "in": "path",
            "name": "page_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the page (or block) to retrieve as markdown. Non-navigable block IDs from truncated responses can be passed here to fetch their subtrees."
            }
          },
          {
            "in": "query",
            "name": "include_transcript",
            "schema": {
              "description": "Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "markdown_version",
            "schema": {
              "description": "The Markdown syntax to use. `v2` is [Notion-flavored Markdown](/guides/data-apis/notion-flavored-markdown) and is recommended. `v1` is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects `v1` with a `400` `validation_error`.",
              "enum": [
                "v1",
                "v2"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/pageMarkdownResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a page as markdown",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.retrieveMarkdown({\n  page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\"\n})\n\nconsole.log(response.markdown)"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-markdown-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-page-markdown"
      },
      "patch": {
        "operationId": "update-page-markdown",
        "parameters": [
          {
            "in": "path",
            "name": "page_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the page to update."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "properties": {
                      "allow_async": {
                        "description": "Set to true to opt into receiving an async_task result when this update operation is accepted for background execution. If omitted or false, the endpoint keeps the existing synchronous response shape.",
                        "type": "boolean"
                      },
                      "markdown_version": {
                        "description": "The Markdown syntax to use. `v2` is [Notion-flavored Markdown](/guides/data-apis/notion-flavored-markdown) and is recommended. `v1` is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects `v1` with a `400` `validation_error`.",
                        "enum": [
                          "v1",
                          "v2"
                        ],
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  {
                    "oneOf": [
                      {
                        "deprecated": true,
                        "properties": {
                          "insert_content": {
                            "description": "Insert new content into the page.",
                            "properties": {
                              "after": {
                                "description": "Selection of existing content to insert after, using the ellipsis format (\"start text...end text\"). Omit to append at the end of the page.",
                                "type": "string"
                              },
                              "content": {
                                "description": "The Markdown content to insert into the page, in the syntax set by `markdown_version`: Notion-flavored Markdown (`v2`, recommended) or enhanced markdown (`v1`, deprecated, the default on current Notion-Versions).",
                                "examples": [
                                  "## New Section\n\nInserted content here."
                                ],
                                "type": "string"
                              },
                              "position": {
                                "description": "Explicit position for inserted content. Use {\"type\":\"start\"} to prepend or {\"type\":\"end\"} to append. Cannot be combined with after.",
                                "oneOf": [
                                  {
                                    "properties": {
                                      "type": {
                                        "const": "start",
                                        "description": "Insert the content at the start of the page.",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "properties": {
                                      "type": {
                                        "const": "end",
                                        "description": "Insert the content at the end of the page.",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ],
                                    "type": "object"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "content"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "const": "insert_content",
                            "description": "Always `insert_content`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "insert_content"
                        ],
                        "title": "Insert Content",
                        "type": "object"
                      },
                      {
                        "deprecated": true,
                        "properties": {
                          "replace_content_range": {
                            "description": "Replace a range of content in the page.",
                            "properties": {
                              "allow_deleting_content": {
                                "description": "Set to true to allow the operation to delete child pages or databases. Defaults to false.",
                                "type": "boolean"
                              },
                              "content": {
                                "description": "The new Markdown content to replace the matched range, in the syntax set by `markdown_version`: Notion-flavored Markdown (`v2`, recommended) or enhanced markdown (`v1`, deprecated, the default on current Notion-Versions).",
                                "examples": [
                                  "## Updated Section\n\nNew content replaces the old."
                                ],
                                "type": "string"
                              },
                              "content_range": {
                                "description": "Selection of existing content to replace, using the ellipsis format (\"start text...end text\").",
                                "type": "string"
                              }
                            },
                            "required": [
                              "content",
                              "content_range"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "const": "replace_content_range",
                            "description": "Always `replace_content_range`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "replace_content_range"
                        ],
                        "title": "Replace Content Range",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "type": {
                            "const": "update_content",
                            "description": "Always `update_content`",
                            "type": "string"
                          },
                          "update_content": {
                            "description": "Update specific content using search-and-replace operations.",
                            "properties": {
                              "allow_deleting_content": {
                                "description": "Set to true to allow the operation to delete child pages or databases. Defaults to false.",
                                "type": "boolean"
                              },
                              "content_updates": {
                                "description": "An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content). Operations that match are applied, and each one that matches nothing is reported in \"warnings\". The call fails only when no operation that changes content matches.",
                                "items": {
                                  "properties": {
                                    "new_str": {
                                      "description": "The new content string to replace old_str with.",
                                      "type": "string"
                                    },
                                    "old_str": {
                                      "description": "The existing content string to find and replace. Must exactly match the page content.",
                                      "minLength": 1,
                                      "type": "string"
                                    },
                                    "replace_all_matches": {
                                      "description": "If true, replaces all occurrences of old_str. If false (default), the operation fails if there are multiple matches.",
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "old_str",
                                    "new_str"
                                  ],
                                  "type": "object"
                                },
                                "maxItems": 100,
                                "type": "array"
                              }
                            },
                            "required": [
                              "content_updates"
                            ],
                            "type": "object"
                          }
                        },
                        "required": [
                          "type",
                          "update_content"
                        ],
                        "title": "Update Content",
                        "type": "object"
                      },
                      {
                        "properties": {
                          "replace_content": {
                            "description": "Replace the entire page content with new markdown.",
                            "properties": {
                              "allow_deleting_content": {
                                "description": "Set to true to allow the operation to delete child pages or databases. Defaults to false.",
                                "type": "boolean"
                              },
                              "new_str": {
                                "description": "The new Markdown content to replace the entire page content, in the syntax set by `markdown_version`: Notion-flavored Markdown (`v2`, recommended) or enhanced markdown (`v1`, deprecated, the default on current Notion-Versions).",
                                "examples": [
                                  "# Updated Page\n\nCompletely new page content."
                                ],
                                "type": "string"
                              }
                            },
                            "required": [
                              "new_str"
                            ],
                            "type": "object"
                          },
                          "type": {
                            "const": "replace_content",
                            "description": "Always `replace_content`",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "replace_content"
                        ],
                        "title": "Replace Content",
                        "type": "object"
                      }
                    ]
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/pageMarkdownResponse"
                }
              }
            },
            "description": ""
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "created_time": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "id": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "object": {
                      "enum": [
                        "async_task"
                      ],
                      "type": "string"
                    },
                    "operation": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "enum": [
                                "PATCH /v1/pages/:page_id/markdown"
                              ],
                              "type": "string"
                            },
                            "surface": {
                              "enum": [
                                "rest"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "name": {
                              "enum": [
                                "create_pages"
                              ],
                              "type": "string"
                            },
                            "surface": {
                              "enum": [
                                "mcp"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "surface",
                            "name"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "poll_after_seconds": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "status": {
                      "enum": [
                        "queued",
                        "running",
                        "retrying"
                      ],
                      "type": "string"
                    },
                    "status_url": {
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "status",
                    "status_url",
                    "created_time",
                    "poll_after_seconds",
                    "operation"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Accepted when `allow_async` is true and the update has been queued for background execution."
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Update a page's content as markdown",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.updateMarkdown({\n  page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\",\n  type: \"update_content\",\n  update_content: {\n    content_updates: [\n      {\n        old_str: \"existing text to find\",\n        new_str: \"replacement text\"\n      }\n    ]\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-markdown-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/update-page-markdown"
      }
    },
    "/v1/pages/{page_id}/move": {},
    "/v1/pages/{page_id}/properties/{property_id}": {
      "get": {
        "operationId": "retrieve-a-page-property",
        "parameters": [
          {
            "in": "path",
            "name": "page_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the page containing the property."
            }
          },
          {
            "in": "path",
            "name": "property_id",
            "required": true,
            "schema": {
              "description": "The ID or name of the property to retrieve.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/propertyItemObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/propertyItemListResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a page property item",
        "tags": [
          "Pages"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.pages.properties.retrieve({\n  page_id: \"b55c9c91-384d-452b-81db-d1ef79372b75\",\n  property_id: \"aBcD\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-page-content"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-a-page-property"
      }
    },
    "/v1/search": {
      "post": {
        "operationId": "post-search",
        "parameters": [
          {
            "in": "query",
            "name": "filter_properties",
            "schema": {
              "description": "Property names or IDs to include in each page's `properties` object. Other properties are left out. Repeat the parameter to pass more than one value, for example `filter_properties=title&filter_properties=Status`. Pages that aren't in a data source always return only `title`. Search skips names or IDs that don't exist on a page.",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "filter": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          },
                          "property": {
                            "enum": [
                              "object"
                            ],
                            "type": "string"
                          },
                          "value": {
                            "enum": [
                              "page",
                              "data_source"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "property",
                          "value"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "in_trash": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "in_trash"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "page_size": {
                    "type": "number"
                  },
                  "query": {
                    "type": "string"
                  },
                  "sort": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "direction": {
                            "enum": [
                              "ascending",
                              "descending"
                            ],
                            "type": "string"
                          },
                          "timestamp": {
                            "enum": [
                              "last_edited_time"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "timestamp",
                          "direction"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "property": {
                            "enum": [
                              "relevance"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "property"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "start_cursor": {
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/pageOrDataSourceListResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Search by title",
        "tags": [
          "Search"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.search({\n  query: \"meeting notes\",\n  filter: {\n    property: \"object\",\n    value: \"page\"\n  },\n  sort: {\n    direction: \"descending\",\n    timestamp: \"last_edited_time\"\n  }\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/data-apis/working-with-databases"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/post-search"
      }
    },
    "/v1/sessions": {},
    "/v1/sessions/query": {
      "post": {
        "operationId": "query-sessions",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "filter": {
                    "description": "A session property filter, or an and/or compound filter nested up to two levels deep.",
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/sessionIdFilter"
                      },
                      {
                        "$ref": "#/components/schemas/sessionAgentIdFilter"
                      },
                      {
                        "$ref": "#/components/schemas/sessionStatusFilter"
                      },
                      {
                        "$ref": "#/components/schemas/sessionTimestampFilter"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "and": {
                            "description": "Return sessions that match every child filter.",
                            "items": {
                              "$ref": "#/components/schemas/sessionNestedFilter"
                            },
                            "maxItems": 100,
                            "type": "array"
                          }
                        },
                        "required": [
                          "and"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "or": {
                            "description": "Return sessions that match any child filter.",
                            "items": {
                              "$ref": "#/components/schemas/sessionNestedFilter"
                            },
                            "maxItems": 100,
                            "type": "array"
                          }
                        },
                        "required": [
                          "or"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "page_size": {
                    "description": "The number of sessions to return. Maximum: 100.",
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "query": {
                    "description": "A case-insensitive substring search over session titles.",
                    "maxLength": 2000,
                    "type": "string"
                  },
                  "sorts": {
                    "description": "Ordered sort precedence. Defaults to updated_at descending.",
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "direction": {
                          "description": "One of: `ascending`, `descending`",
                          "enum": [
                            "ascending",
                            "descending"
                          ],
                          "type": "string"
                        },
                        "property": {
                          "description": "One of: `created_at`, `updated_at`",
                          "enum": [
                            "created_at",
                            "updated_at"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "property",
                        "direction"
                      ],
                      "type": "object"
                    },
                    "maxItems": 2,
                    "minItems": 1,
                    "type": "array"
                  },
                  "start_cursor": {
                    "description": "The continuation cursor returned by the previous page.",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "description": "Whether more session candidates remain after this bounded scan.",
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "description": "Pass this cursor as start_cursor when has_more is true, even when results is empty.",
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "results": {
                      "description": "Sessions found in this bounded scan. Access filtering can leave this array empty while has_more is true.",
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "agent_id": {
                            "type": "string"
                          },
                          "agent_version": {
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "number": {
                                    "minimum": 1,
                                    "type": "integer"
                                  },
                                  "published_at": {
                                    "format": "date-time",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "number",
                                  "published_at"
                                ],
                                "type": "object"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "chat_user_emails": {
                            "oneOf": [
                              {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "created_at": {
                            "format": "date-time",
                            "type": "string"
                          },
                          "created_by": {
                            "additionalProperties": true,
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "type": {
                                "description": "One of: `user`, `bot`",
                                "enum": [
                                  "user",
                                  "bot"
                                ],
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "type"
                            ],
                            "type": "object"
                          },
                          "credits_used": {
                            "description": "Premium AI credits this session consumed. Reported with at most two decimal places, rounded down.",
                            "oneOf": [
                              {
                                "minimum": 0,
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "error": {
                            "additionalProperties": true,
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "retryable": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "code",
                              "message",
                              "retryable"
                            ],
                            "type": "object"
                          },
                          "id": {
                            "type": "string"
                          },
                          "message_count": {
                            "oneOf": [
                              {
                                "minimum": 0,
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "models": {
                            "oneOf": [
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "type": {
                                    "const": "auto",
                                    "description": "Always `auto`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "ids": {
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "string"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "type": "array"
                                  },
                                  "type": {
                                    "const": "pinned",
                                    "description": "Always `pinned`",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type",
                                  "ids"
                                ],
                                "type": "object"
                              }
                            ]
                          },
                          "object": {
                            "const": "session",
                            "description": "Always `session`",
                            "type": "string"
                          },
                          "required_actions": {
                            "items": {
                              "additionalProperties": true,
                              "properties": {
                                "action_id": {
                                  "type": "string"
                                },
                                "options": {
                                  "items": {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "description": "One of: `approve`, `reject`",
                                        "enum": [
                                          "approve",
                                          "reject"
                                        ],
                                        "type": "string"
                                      },
                                      "label": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "label"
                                    ],
                                    "type": "object"
                                  },
                                  "maxItems": 100,
                                  "type": "array"
                                },
                                "title": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "action_id",
                                "title",
                                "options"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "runs_completed": {
                            "oneOf": [
                              {
                                "minimum": 0,
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "status": {
                            "description": "One of: `queued`, `in_progress`, `requires_action`, `completed`, `failed`, `canceled`, `terminated`",
                            "enum": [
                              "queued",
                              "in_progress",
                              "requires_action",
                              "completed",
                              "failed",
                              "canceled",
                              "terminated"
                            ],
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "tool_call_count": {
                            "oneOf": [
                              {
                                "minimum": 0,
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "tool_types": {
                            "oneOf": [
                              {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "trigger_type": {
                            "type": "string"
                          },
                          "type_labels": {
                            "oneOf": [
                              {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "updated_at": {
                            "format": "date-time",
                            "type": "string"
                          }
                        },
                        "required": [
                          "object",
                          "id",
                          "agent_id",
                          "title",
                          "status",
                          "created_by",
                          "agent_version",
                          "models",
                          "created_at",
                          "updated_at"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "session": {
                      "additionalProperties": true,
                      "properties": {},
                      "type": "object"
                    },
                    "type": {
                      "const": "session",
                      "description": "Always `session`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "type",
                    "session",
                    "results",
                    "has_more",
                    "next_cursor"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Query sessions",
        "tags": [
          "Sessions"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.sessions.query({\n  filter: { property: \"agent_id\", string: { equals: \"1f0c7c06-781b-4987-9986-5c8dd3028013\" } },\n  sorts: [{ property: \"updated_at\", direction: \"descending\" }],\n  page_size: 10\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/query-sessions",
        "x-notion-sdk-method": "sessions.query"
      }
    },
    "/v1/sessions/{session_id}": {
      "get": {
        "operationId": "retrieve-session",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the session to retrieve."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_id": {
                      "type": "string"
                    },
                    "agent_version": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "number": {
                              "minimum": 1,
                              "type": "integer"
                            },
                            "published_at": {
                              "format": "date-time",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "number",
                            "published_at"
                          ],
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "chat_user_emails": {
                      "oneOf": [
                        {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "created_by": {
                      "additionalProperties": true,
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "type": {
                          "description": "One of: `user`, `bot`",
                          "enum": [
                            "user",
                            "bot"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "type"
                      ],
                      "type": "object"
                    },
                    "credits_used": {
                      "description": "Premium AI credits this session consumed. Reported with at most two decimal places, rounded down.",
                      "oneOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "error": {
                      "additionalProperties": true,
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "retryable"
                      ],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "message_count": {
                      "oneOf": [
                        {
                          "minimum": 0,
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "models": {
                      "oneOf": [
                        {
                          "additionalProperties": true,
                          "properties": {
                            "type": {
                              "const": "auto",
                              "description": "Always `auto`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "type": "object"
                        },
                        {
                          "additionalProperties": true,
                          "properties": {
                            "ids": {
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "type": "array"
                            },
                            "type": {
                              "const": "pinned",
                              "description": "Always `pinned`",
                              "type": "string"
                            }
                          },
                          "required": [
                            "type",
                            "ids"
                          ],
                          "type": "object"
                        }
                      ]
                    },
                    "object": {
                      "const": "session",
                      "description": "Always `session`",
                      "type": "string"
                    },
                    "required_actions": {
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "action_id": {
                            "type": "string"
                          },
                          "options": {
                            "items": {
                              "additionalProperties": true,
                              "properties": {
                                "id": {
                                  "description": "One of: `approve`, `reject`",
                                  "enum": [
                                    "approve",
                                    "reject"
                                  ],
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "label"
                              ],
                              "type": "object"
                            },
                            "maxItems": 100,
                            "type": "array"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "action_id",
                          "title",
                          "options"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "runs_completed": {
                      "oneOf": [
                        {
                          "minimum": 0,
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "status": {
                      "description": "One of: `queued`, `in_progress`, `requires_action`, `completed`, `failed`, `canceled`, `terminated`",
                      "enum": [
                        "queued",
                        "in_progress",
                        "requires_action",
                        "completed",
                        "failed",
                        "canceled",
                        "terminated"
                      ],
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "tool_call_count": {
                      "oneOf": [
                        {
                          "minimum": 0,
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "tool_types": {
                      "oneOf": [
                        {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "trigger_type": {
                      "type": "string"
                    },
                    "type_labels": {
                      "oneOf": [
                        {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "agent_id",
                    "title",
                    "status",
                    "created_at",
                    "updated_at",
                    "created_by",
                    "agent_version",
                    "models"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a session",
        "tags": [
          "Sessions"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.sessions.retrieve({\n  session_id: \"2a1c7c06-781b-4987-9986-5c8dd3028014\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/retrieve-session",
        "x-notion-sdk-method": "sessions.retrieve"
      }
    },
    "/v1/sessions/{session_id}/cancel": {
      "post": {
        "operationId": "cancel-session",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the session to cancel."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "event_id": {
                    "description": "A session event identifying the turn to cancel. If omitted, cancels the current nonterminal turn.",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "agent_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "error": {
                      "additionalProperties": true,
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "retryable"
                      ],
                      "type": "object"
                    },
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "const": "session",
                      "description": "Always `session`",
                      "type": "string"
                    },
                    "required_actions": {
                      "items": {
                        "additionalProperties": true,
                        "properties": {
                          "action_id": {
                            "type": "string"
                          },
                          "options": {
                            "items": {
                              "additionalProperties": true,
                              "properties": {
                                "id": {
                                  "description": "One of: `approve`, `reject`",
                                  "enum": [
                                    "approve",
                                    "reject"
                                  ],
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "label"
                              ],
                              "type": "object"
                            },
                            "maxItems": 100,
                            "type": "array"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "action_id",
                          "title",
                          "options"
                        ],
                        "type": "object"
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "status": {
                      "description": "One of: `queued`, `in_progress`, `requires_action`, `completed`, `failed`, `canceled`, `terminated`",
                      "enum": [
                        "queued",
                        "in_progress",
                        "requires_action",
                        "completed",
                        "failed",
                        "canceled",
                        "terminated"
                      ],
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "updated_at": {
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "id",
                    "agent_id",
                    "title",
                    "status",
                    "created_at",
                    "updated_at"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Cancel a session",
        "tags": [
          "Sessions"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.sessions.cancel({\n  session_id: \"2a1c7c06-781b-4987-9986-5c8dd3028014\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/cancel-session",
        "x-notion-sdk-method": "sessions.cancel"
      }
    },
    "/v1/sessions/{session_id}/events/query": {
      "post": {
        "operationId": "query-session-events",
        "parameters": [
          {
            "in": "path",
            "name": "session_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the session whose events should be queried."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "filter": {
                    "description": "A session event property filter, or an and/or compound filter nested up to three levels deep.",
                    "oneOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "property": {
                            "enum": [
                              "id"
                            ],
                            "type": "string"
                          },
                          "string": {
                            "additionalProperties": false,
                            "properties": {
                              "equals": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "equals"
                            ],
                            "type": "object"
                          }
                        },
                        "required": [
                          "property",
                          "string"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "event_type": {
                            "additionalProperties": false,
                            "properties": {
                              "equals": {
                                "enum": [
                                  "user.message",
                                  "agent.message",
                                  "agent.thinking",
                                  "agent.tool_use",
                                  "agent.tool_result",
                                  "session.status"
                                ],
                                "type": "string"
                              },
                              "in": {
                                "items": {
                                  "enum": [
                                    "user.message",
                                    "agent.message",
                                    "agent.thinking",
                                    "agent.tool_use",
                                    "agent.tool_result",
                                    "session.status"
                                  ],
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            },
                            "type": "object"
                          },
                          "property": {
                            "enum": [
                              "type"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "property",
                          "event_type"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "number": {
                            "additionalProperties": false,
                            "properties": {
                              "greater_than": {
                                "type": "number"
                              },
                              "greater_than_or_equal_to": {
                                "type": "number"
                              },
                              "less_than": {
                                "type": "number"
                              },
                              "less_than_or_equal_to": {
                                "type": "number"
                              }
                            },
                            "type": "object"
                          },
                          "property": {
                            "enum": [
                              "sequence"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "property",
                          "number"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "property": {
                            "enum": [
                              "created_at"
                            ],
                            "type": "string"
                          },
                          "timestamp": {
                            "additionalProperties": false,
                            "properties": {
                              "after": {
                                "format": "date-time",
                                "type": "string"
                              },
                              "before": {
                                "format": "date-time",
                                "type": "string"
                              },
                              "equals": {
                                "format": "date-time",
                                "type": "string"
                              },
                              "on_or_after": {
                                "format": "date-time",
                                "type": "string"
                              },
                              "on_or_before": {
                                "format": "date-time",
                                "type": "string"
                              }
                            },
                            "type": "object"
                          }
                        },
                        "required": [
                          "property",
                          "timestamp"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "and": {
                            "items": {
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "property": {
                                      "enum": [
                                        "id"
                                      ],
                                      "type": "string"
                                    },
                                    "string": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "equals": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "equals"
                                      ],
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "string"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "event_type": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "equals": {
                                          "enum": [
                                            "user.message",
                                            "agent.message",
                                            "agent.thinking",
                                            "agent.tool_use",
                                            "agent.tool_result",
                                            "session.status"
                                          ],
                                          "type": "string"
                                        },
                                        "in": {
                                          "items": {
                                            "enum": [
                                              "user.message",
                                              "agent.message",
                                              "agent.thinking",
                                              "agent.tool_use",
                                              "agent.tool_result",
                                              "session.status"
                                            ],
                                            "type": "string"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    "property": {
                                      "enum": [
                                        "type"
                                      ],
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "event_type"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "number": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "greater_than": {
                                          "type": "number"
                                        },
                                        "greater_than_or_equal_to": {
                                          "type": "number"
                                        },
                                        "less_than": {
                                          "type": "number"
                                        },
                                        "less_than_or_equal_to": {
                                          "type": "number"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    "property": {
                                      "enum": [
                                        "sequence"
                                      ],
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "number"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "property": {
                                      "enum": [
                                        "created_at"
                                      ],
                                      "type": "string"
                                    },
                                    "timestamp": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "after": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "before": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "equals": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "on_or_after": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "on_or_before": {
                                          "format": "date-time",
                                          "type": "string"
                                        }
                                      },
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "timestamp"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "and": {
                                      "items": {
                                        "oneOf": [
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "id"
                                                ],
                                                "type": "string"
                                              },
                                              "string": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "equals"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "string"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "event_type": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "enum": [
                                                      "user.message",
                                                      "agent.message",
                                                      "agent.thinking",
                                                      "agent.tool_use",
                                                      "agent.tool_result",
                                                      "session.status"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "in": {
                                                    "items": {
                                                      "enum": [
                                                        "user.message",
                                                        "agent.message",
                                                        "agent.thinking",
                                                        "agent.tool_use",
                                                        "agent.tool_result",
                                                        "session.status"
                                                      ],
                                                      "type": "string"
                                                    },
                                                    "type": "array"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "type"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "event_type"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "number": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "greater_than": {
                                                    "type": "number"
                                                  },
                                                  "greater_than_or_equal_to": {
                                                    "type": "number"
                                                  },
                                                  "less_than": {
                                                    "type": "number"
                                                  },
                                                  "less_than_or_equal_to": {
                                                    "type": "number"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "sequence"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "number"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "created_at"
                                                ],
                                                "type": "string"
                                              },
                                              "timestamp": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "equals": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  }
                                                },
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "timestamp"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "and": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "and"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "or": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "or"
                                            ],
                                            "type": "object"
                                          }
                                        ]
                                      },
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "and"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "or": {
                                      "items": {
                                        "oneOf": [
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "id"
                                                ],
                                                "type": "string"
                                              },
                                              "string": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "equals"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "string"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "event_type": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "enum": [
                                                      "user.message",
                                                      "agent.message",
                                                      "agent.thinking",
                                                      "agent.tool_use",
                                                      "agent.tool_result",
                                                      "session.status"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "in": {
                                                    "items": {
                                                      "enum": [
                                                        "user.message",
                                                        "agent.message",
                                                        "agent.thinking",
                                                        "agent.tool_use",
                                                        "agent.tool_result",
                                                        "session.status"
                                                      ],
                                                      "type": "string"
                                                    },
                                                    "type": "array"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "type"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "event_type"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "number": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "greater_than": {
                                                    "type": "number"
                                                  },
                                                  "greater_than_or_equal_to": {
                                                    "type": "number"
                                                  },
                                                  "less_than": {
                                                    "type": "number"
                                                  },
                                                  "less_than_or_equal_to": {
                                                    "type": "number"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "sequence"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "number"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "created_at"
                                                ],
                                                "type": "string"
                                              },
                                              "timestamp": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "equals": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  }
                                                },
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "timestamp"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "and": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "and"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "or": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "or"
                                            ],
                                            "type": "object"
                                          }
                                        ]
                                      },
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "or"
                                  ],
                                  "type": "object"
                                }
                              ]
                            },
                            "type": "array"
                          }
                        },
                        "required": [
                          "and"
                        ],
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "or": {
                            "items": {
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "property": {
                                      "enum": [
                                        "id"
                                      ],
                                      "type": "string"
                                    },
                                    "string": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "equals": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "equals"
                                      ],
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "string"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "event_type": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "equals": {
                                          "enum": [
                                            "user.message",
                                            "agent.message",
                                            "agent.thinking",
                                            "agent.tool_use",
                                            "agent.tool_result",
                                            "session.status"
                                          ],
                                          "type": "string"
                                        },
                                        "in": {
                                          "items": {
                                            "enum": [
                                              "user.message",
                                              "agent.message",
                                              "agent.thinking",
                                              "agent.tool_use",
                                              "agent.tool_result",
                                              "session.status"
                                            ],
                                            "type": "string"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    "property": {
                                      "enum": [
                                        "type"
                                      ],
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "event_type"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "number": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "greater_than": {
                                          "type": "number"
                                        },
                                        "greater_than_or_equal_to": {
                                          "type": "number"
                                        },
                                        "less_than": {
                                          "type": "number"
                                        },
                                        "less_than_or_equal_to": {
                                          "type": "number"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    "property": {
                                      "enum": [
                                        "sequence"
                                      ],
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "number"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "property": {
                                      "enum": [
                                        "created_at"
                                      ],
                                      "type": "string"
                                    },
                                    "timestamp": {
                                      "additionalProperties": false,
                                      "properties": {
                                        "after": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "before": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "equals": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "on_or_after": {
                                          "format": "date-time",
                                          "type": "string"
                                        },
                                        "on_or_before": {
                                          "format": "date-time",
                                          "type": "string"
                                        }
                                      },
                                      "type": "object"
                                    }
                                  },
                                  "required": [
                                    "property",
                                    "timestamp"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "and": {
                                      "items": {
                                        "oneOf": [
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "id"
                                                ],
                                                "type": "string"
                                              },
                                              "string": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "equals"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "string"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "event_type": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "enum": [
                                                      "user.message",
                                                      "agent.message",
                                                      "agent.thinking",
                                                      "agent.tool_use",
                                                      "agent.tool_result",
                                                      "session.status"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "in": {
                                                    "items": {
                                                      "enum": [
                                                        "user.message",
                                                        "agent.message",
                                                        "agent.thinking",
                                                        "agent.tool_use",
                                                        "agent.tool_result",
                                                        "session.status"
                                                      ],
                                                      "type": "string"
                                                    },
                                                    "type": "array"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "type"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "event_type"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "number": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "greater_than": {
                                                    "type": "number"
                                                  },
                                                  "greater_than_or_equal_to": {
                                                    "type": "number"
                                                  },
                                                  "less_than": {
                                                    "type": "number"
                                                  },
                                                  "less_than_or_equal_to": {
                                                    "type": "number"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "sequence"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "number"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "created_at"
                                                ],
                                                "type": "string"
                                              },
                                              "timestamp": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "equals": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  }
                                                },
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "timestamp"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "and": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "and"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "or": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "or"
                                            ],
                                            "type": "object"
                                          }
                                        ]
                                      },
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "and"
                                  ],
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "or": {
                                      "items": {
                                        "oneOf": [
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "id"
                                                ],
                                                "type": "string"
                                              },
                                              "string": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "equals"
                                                ],
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "string"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "event_type": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "equals": {
                                                    "enum": [
                                                      "user.message",
                                                      "agent.message",
                                                      "agent.thinking",
                                                      "agent.tool_use",
                                                      "agent.tool_result",
                                                      "session.status"
                                                    ],
                                                    "type": "string"
                                                  },
                                                  "in": {
                                                    "items": {
                                                      "enum": [
                                                        "user.message",
                                                        "agent.message",
                                                        "agent.thinking",
                                                        "agent.tool_use",
                                                        "agent.tool_result",
                                                        "session.status"
                                                      ],
                                                      "type": "string"
                                                    },
                                                    "type": "array"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "type"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "event_type"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "number": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "greater_than": {
                                                    "type": "number"
                                                  },
                                                  "greater_than_or_equal_to": {
                                                    "type": "number"
                                                  },
                                                  "less_than": {
                                                    "type": "number"
                                                  },
                                                  "less_than_or_equal_to": {
                                                    "type": "number"
                                                  }
                                                },
                                                "type": "object"
                                              },
                                              "property": {
                                                "enum": [
                                                  "sequence"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "number"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "property": {
                                                "enum": [
                                                  "created_at"
                                                ],
                                                "type": "string"
                                              },
                                              "timestamp": {
                                                "additionalProperties": false,
                                                "properties": {
                                                  "after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "equals": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_after": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  },
                                                  "on_or_before": {
                                                    "format": "date-time",
                                                    "type": "string"
                                                  }
                                                },
                                                "type": "object"
                                              }
                                            },
                                            "required": [
                                              "property",
                                              "timestamp"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "and": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "and"
                                            ],
                                            "type": "object"
                                          },
                                          {
                                            "additionalProperties": false,
                                            "properties": {
                                              "or": {
                                                "items": {
                                                  "oneOf": [
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "id"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "string": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "type": "string"
                                                            }
                                                          },
                                                          "required": [
                                                            "equals"
                                                          ],
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "string"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "event_type": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "equals": {
                                                              "enum": [
                                                                "user.message",
                                                                "agent.message",
                                                                "agent.thinking",
                                                                "agent.tool_use",
                                                                "agent.tool_result",
                                                                "session.status"
                                                              ],
                                                              "type": "string"
                                                            },
                                                            "in": {
                                                              "items": {
                                                                "enum": [
                                                                  "user.message",
                                                                  "agent.message",
                                                                  "agent.thinking",
                                                                  "agent.tool_use",
                                                                  "agent.tool_result",
                                                                  "session.status"
                                                                ],
                                                                "type": "string"
                                                              },
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "type"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "event_type"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "number": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "greater_than": {
                                                              "type": "number"
                                                            },
                                                            "greater_than_or_equal_to": {
                                                              "type": "number"
                                                            },
                                                            "less_than": {
                                                              "type": "number"
                                                            },
                                                            "less_than_or_equal_to": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "property": {
                                                          "enum": [
                                                            "sequence"
                                                          ],
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "number"
                                                      ],
                                                      "type": "object"
                                                    },
                                                    {
                                                      "additionalProperties": false,
                                                      "properties": {
                                                        "property": {
                                                          "enum": [
                                                            "created_at"
                                                          ],
                                                          "type": "string"
                                                        },
                                                        "timestamp": {
                                                          "additionalProperties": false,
                                                          "properties": {
                                                            "after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "equals": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_after": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            },
                                                            "on_or_before": {
                                                              "format": "date-time",
                                                              "type": "string"
                                                            }
                                                          },
                                                          "type": "object"
                                                        }
                                                      },
                                                      "required": [
                                                        "property",
                                                        "timestamp"
                                                      ],
                                                      "type": "object"
                                                    }
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "required": [
                                              "or"
                                            ],
                                            "type": "object"
                                          }
                                        ]
                                      },
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "or"
                                  ],
                                  "type": "object"
                                }
                              ]
                            },
                            "type": "array"
                          }
                        },
                        "required": [
                          "or"
                        ],
                        "type": "object"
                      }
                    ]
                  },
                  "page_size": {
                    "description": "The number of events to return. Maximum: 100.",
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "sorts": {
                    "description": "Ordered sort precedence. Defaults to sequence ascending.",
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "direction": {
                          "description": "One of: `ascending`, `descending`",
                          "enum": [
                            "ascending",
                            "descending"
                          ],
                          "type": "string"
                        },
                        "property": {
                          "description": "One of: `sequence`, `created_at`",
                          "enum": [
                            "sequence",
                            "created_at"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "property",
                        "direction"
                      ],
                      "type": "object"
                    },
                    "maxItems": 2,
                    "minItems": 1,
                    "type": "array"
                  },
                  "start_cursor": {
                    "description": "The continuation cursor returned by the previous page.",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "title": "Cursor",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "oneOf": [
                          {
                            "additionalProperties": true,
                            "properties": {
                              "content": {
                                "items": {
                                  "oneOf": [
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "text": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "const": "text",
                                          "description": "Always `text`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "text"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "content_type": {
                                          "type": "string"
                                        },
                                        "expiry_time": {
                                          "type": "string"
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "const": "file",
                                          "description": "Always `file`",
                                          "type": "string"
                                        },
                                        "url": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "content_type",
                                        "url"
                                      ],
                                      "type": "object"
                                    }
                                  ]
                                },
                                "type": "array"
                              },
                              "created_at": {
                                "type": "string"
                              },
                              "created_by": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "description": "One of: `user`, `bot`",
                                        "enum": [
                                          "user",
                                          "bot"
                                        ],
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "type"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "metadata": {
                                "oneOf": [
                                  {
                                    "additionalProperties": {
                                      "maxLength": 2000,
                                      "type": "string"
                                    },
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "type": {
                                "const": "user.message",
                                "description": "Always `user.message`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "content",
                              "created_by",
                              "metadata"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "content": {
                                "items": {
                                  "oneOf": [
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "text": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "const": "text",
                                          "description": "Always `text`",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "text"
                                      ],
                                      "type": "object"
                                    },
                                    {
                                      "additionalProperties": true,
                                      "properties": {
                                        "content_type": {
                                          "type": "string"
                                        },
                                        "expiry_time": {
                                          "type": "string"
                                        },
                                        "name": {
                                          "type": "string"
                                        },
                                        "type": {
                                          "const": "file",
                                          "description": "Always `file`",
                                          "type": "string"
                                        },
                                        "url": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "name",
                                        "content_type",
                                        "url"
                                      ],
                                      "type": "object"
                                    }
                                  ]
                                },
                                "type": "array"
                              },
                              "created_at": {
                                "type": "string"
                              },
                              "created_by": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "id": {
                                        "type": "string"
                                      },
                                      "type": {
                                        "description": "One of: `user`, `bot`",
                                        "enum": [
                                          "user",
                                          "bot"
                                        ],
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "type"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "metadata": {
                                "oneOf": [
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "model": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "model"
                                    ],
                                    "type": "object"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "type": {
                                "const": "agent.message",
                                "description": "Always `agent.message`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "content",
                              "created_by",
                              "metadata"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "content": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "text": {
                                      "type": "string"
                                    },
                                    "type": {
                                      "const": "text",
                                      "description": "Always `text`",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "text"
                                  ],
                                  "type": "object"
                                },
                                "type": "array"
                              },
                              "created_at": {
                                "type": "string"
                              },
                              "id": {
                                "type": "string"
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "type": {
                                "const": "agent.thinking",
                                "description": "Always `agent.thinking`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "content"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "created_at": {
                                "type": "string"
                              },
                              "id": {
                                "type": "string"
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "tool_name": {
                                "type": "string"
                              },
                              "type": {
                                "const": "agent.tool_use",
                                "description": "Always `agent.tool_use`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "tool_name"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "created_at": {
                                "type": "string"
                              },
                              "id": {
                                "type": "string"
                              },
                              "is_error": {
                                "type": "boolean"
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "tool_name": {
                                "type": "string"
                              },
                              "tool_use_id": {
                                "type": "string"
                              },
                              "type": {
                                "const": "agent.tool_result",
                                "description": "Always `agent.tool_result`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "tool_use_id",
                              "tool_name",
                              "is_error"
                            ],
                            "type": "object"
                          },
                          {
                            "additionalProperties": true,
                            "properties": {
                              "created_at": {
                                "type": "string"
                              },
                              "error": {
                                "additionalProperties": true,
                                "properties": {
                                  "code": {
                                    "type": "string"
                                  },
                                  "message": {
                                    "type": "string"
                                  },
                                  "retryable": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "code",
                                  "message",
                                  "retryable"
                                ],
                                "type": "object"
                              },
                              "id": {
                                "type": "string"
                              },
                              "object": {
                                "const": "session_event",
                                "description": "Always `session_event`",
                                "type": "string"
                              },
                              "required_actions": {
                                "items": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "action_id": {
                                      "type": "string"
                                    },
                                    "options": {
                                      "items": {
                                        "additionalProperties": true,
                                        "properties": {
                                          "id": {
                                            "description": "One of: `approve`, `reject`",
                                            "enum": [
                                              "approve",
                                              "reject"
                                            ],
                                            "type": "string"
                                          },
                                          "label": {
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "label"
                                        ],
                                        "type": "object"
                                      },
                                      "maxItems": 100,
                                      "type": "array"
                                    },
                                    "title": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "action_id",
                                    "title",
                                    "options"
                                  ],
                                  "type": "object"
                                },
                                "type": "array"
                              },
                              "sequence": {
                                "minimum": 1,
                                "type": "integer"
                              },
                              "session_id": {
                                "type": "string"
                              },
                              "status": {
                                "description": "One of: `requires_action`, `completed`, `failed`, `canceled`, `terminated`",
                                "enum": [
                                  "requires_action",
                                  "completed",
                                  "failed",
                                  "canceled",
                                  "terminated"
                                ],
                                "type": "string"
                              },
                              "type": {
                                "const": "session.status",
                                "description": "Always `session.status`",
                                "type": "string"
                              }
                            },
                            "required": [
                              "object",
                              "id",
                              "session_id",
                              "sequence",
                              "created_at",
                              "type",
                              "status"
                            ],
                            "type": "object"
                          }
                        ]
                      },
                      "maxItems": 100,
                      "type": "array"
                    },
                    "session_event": {
                      "additionalProperties": true,
                      "properties": {},
                      "type": "object"
                    },
                    "type": {
                      "const": "session_event",
                      "description": "Always `session_event`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "type",
                    "session_event",
                    "results",
                    "has_more",
                    "next_cursor"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Query session events",
        "tags": [
          "Sessions"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.sessions.queryEvents({\n  session_id: \"2a1c7c06-781b-4987-9986-5c8dd3028014\",\n  filter: { property: \"type\", event_type: { equals: \"agent.message\" } }\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/notion-agent-apis/query-session-events",
        "x-notion-sdk-method": "sessions.queryEvents"
      }
    },
    "/v1/users": {
      "get": {
        "operationId": "get-users",
        "parameters": [
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "object": {
                      "const": "list",
                      "type": "string"
                    },
                    "results": {
                      "items": {
                        "$ref": "#/components/schemas/userObjectResponse"
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "user",
                      "type": "string"
                    },
                    "user": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    }
                  },
                  "required": [
                    "type",
                    "user",
                    "object",
                    "next_cursor",
                    "has_more",
                    "results"
                  ],
                  "title": "User",
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List all users",
        "tags": [
          "Users"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.users.list({\n  start_cursor: undefined,\n  page_size: 10\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/connections-and-tokens/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/get-users"
      }
    },
    "/v1/users/me": {
      "get": {
        "operationId": "get-self",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/userObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve your token's bot user",
        "tags": [
          "Users"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.users.me()"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/connections-and-tokens/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/get-self"
      }
    },
    "/v1/users/{user_id}": {
      "get": {
        "operationId": "get-user",
        "parameters": [
          {
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the user or bot to retrieve."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/userObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a user",
        "tags": [
          "Users"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.users.retrieve({\n  user_id: \"e79a0b74-3aba-4149-9f74-0bb5791a6ee6\"\n})"
          }
        ],
        "x-notion-docs-guides": [
          "https://developers.notion.com/guides/connections-and-tokens/overview"
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/get-user"
      }
    },
    "/v1/views": {
      "get": {
        "operationId": "list-views",
        "parameters": [
          {
            "in": "query",
            "name": "database_id",
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion database (collection view block) to list views for. At least one of database_id or data_source_id is required."
            }
          },
          {
            "in": "query",
            "name": "data_source_id",
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a data source (collection) to list all views for, including linked views across the workspace. At least one of database_id or data_source_id is required."
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of items from the full list desired in the response. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "request_status": {
                      "$ref": "#/components/schemas/requestStatusResponse"
                    },
                    "results": {
                      "items": {
                        "$ref": "#/components/schemas/dataSourceViewReferenceResponse"
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "view",
                      "description": "Always `view`",
                      "type": "string"
                    },
                    "view": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    }
                  },
                  "required": [
                    "object",
                    "next_cursor",
                    "has_more",
                    "results",
                    "type",
                    "view"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "List views",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.list({\n  database_id: \"248104cd-477e-80fd-b757-e945d38000bd\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/list-views"
      }
    },
    "/v1/views/{view_id}": {
      "delete": {
        "operationId": "delete-view",
        "parameters": [
          {
            "in": "path",
            "name": "view_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the view to delete."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/partialDataSourceViewObjectResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Delete a view",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.delete({\n  view_id: \"a3f1b2c4-5678-4def-abcd-1234567890ab\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/delete-view"
      },
      "get": {
        "operationId": "retrieve-a-view",
        "parameters": [
          {
            "in": "path",
            "name": "view_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "ID of a Notion view."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/partialDataSourceViewObjectResponse"
                    },
                    {
                      "$ref": "#/components/schemas/dataSourceViewObjectResponse"
                    }
                  ]
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Retrieve a view",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.retrieve({\n  view_id: \"a3f1b2c4-5678-4def-abcd-1234567890ab\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/retrieve-a-view"
      }
    },
    "/v1/views/{view_id}/queries": {
      "post": {
        "operationId": "create-view-query",
        "parameters": [
          {
            "in": "path",
            "name": "view_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the view."
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createViewQueryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/viewQueryResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Create a view query",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.queries.create({\n  view_id: \"a3f1b2c4-5678-4def-abcd-1234567890ab\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/create-view-query"
      }
    },
    "/v1/views/{view_id}/queries/{query_id}": {
      "delete": {
        "operationId": "delete-view-query",
        "parameters": [
          {
            "in": "path",
            "name": "view_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the view."
            }
          },
          {
            "in": "path",
            "name": "query_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the query."
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deletedViewQueryResponse"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Delete a view query",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.queries.delete({\n  view_id: \"a3f1b2c4-5678-4def-abcd-1234567890ab\",\n  query_id: \"b4e2c3d5-6789-4abc-def0-1234567890cd\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/delete-view-query"
      },
      "get": {
        "operationId": "get-view-query-results",
        "parameters": [
          {
            "in": "path",
            "name": "view_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the view."
            }
          },
          {
            "in": "path",
            "name": "query_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/idRequest",
              "description": "The ID of the query."
            }
          },
          {
            "in": "query",
            "name": "start_cursor",
            "schema": {
              "description": "If supplied, this endpoint will return a page of results starting after the cursor provided.",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "schema": {
              "description": "The number of results to return per page. Maximum: 100",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/idResponse"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "object": {
                      "const": "list",
                      "description": "Always `list`",
                      "type": "string"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CompatibleResponseemptyObject"
                    },
                    "request_status": {
                      "$ref": "#/components/schemas/requestStatusResponse"
                    },
                    "results": {
                      "items": {
                        "$ref": "#/components/schemas/partialPageObjectResponse"
                      },
                      "type": "array"
                    },
                    "type": {
                      "const": "page",
                      "description": "Always `page`",
                      "type": "string"
                    }
                  },
                  "required": [
                    "object",
                    "next_cursor",
                    "has_more",
                    "results",
                    "type",
                    "page"
                  ],
                  "type": "object"
                }
              }
            },
            "description": ""
          },
          "400": {
            "$ref": "#/components/responses/error_api_400"
          },
          "401": {
            "$ref": "#/components/responses/error_api_401"
          },
          "403": {
            "$ref": "#/components/responses/error_api_403"
          },
          "404": {
            "$ref": "#/components/responses/error_api_404"
          },
          "406": {
            "$ref": "#/components/responses/error_api_406"
          },
          "409": {
            "$ref": "#/components/responses/error_api_409"
          },
          "429": {
            "$ref": "#/components/responses/error_api_429"
          },
          "500": {
            "$ref": "#/components/responses/error_api_500"
          },
          "503": {
            "$ref": "#/components/responses/error_api_503"
          },
          "504": {
            "$ref": "#/components/responses/error_api_504"
          },
          "529": {
            "$ref": "#/components/responses/error_api_529"
          }
        },
        "summary": "Get view query results",
        "tags": [
          "Views"
        ],
        "x-codeSamples": [
          {
            "label": "TypeScript SDK",
            "lang": "javascript",
            "source": "import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.views.queries.results({\n  view_id: \"a3f1b2c4-5678-4def-abcd-1234567890ab\",\n  query_id: \"b4e2c3d5-6789-4abc-def0-1234567890cd\"\n})"
          }
        ],
        "x-notion-docs-ref": "https://developers.notion.com/reference/get-view-query-results"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.notion.com"
    }
  ],
  "tags": [
    {
      "description": "Skill and plugin directory endpoints",
      "name": "Agent Skills"
    },
    {
      "description": "Database endpoints",
      "name": "Databases"
    },
    {
      "description": "Data source endpoints",
      "name": "Data sources"
    },
    {
      "description": "Page endpoints",
      "name": "Pages"
    },
    {
      "description": "Async task endpoints",
      "name": "Async tasks"
    },
    {
      "description": "Block endpoints",
      "name": "Blocks"
    },
    {
      "description": "Comment endpoints",
      "name": "Comments"
    },
    {
      "description": "File upload endpoints",
      "name": "File uploads"
    },
    {
      "description": "OAuth endpoints (basic authentication)",
      "name": "OAuth"
    },
    {
      "description": "User endpoints",
      "name": "Users"
    },
    {
      "description": "Search endpoints",
      "name": "Search"
    },
    {
      "description": "View endpoints",
      "name": "Views"
    },
    {
      "description": "Agent endpoints",
      "name": "Agents"
    },
    {
      "description": "Session endpoints",
      "name": "Sessions"
    },
    {
      "description": "Custom emoji endpoints",
      "name": "Custom emojis"
    },
    {
      "description": "Meeting notes endpoints",
      "name": "Meeting notes"
    }
  ],
  "webhooks": {
    "commentCreated": {
      "post": {
        "description": "Webhook event for comment created in a workspace",
        "operationId": "webhook-comment-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/commentCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Comment created",
        "tags": [
          "Comment webhooks"
        ]
      }
    },
    "commentDeleted": {
      "post": {
        "description": "Webhook event for comment deleted in a workspace",
        "operationId": "webhook-comment-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/commentDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Comment deleted",
        "tags": [
          "Comment webhooks"
        ]
      }
    },
    "commentUpdated": {
      "post": {
        "description": "Webhook event for comment updated in a workspace",
        "operationId": "webhook-comment-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/commentUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Comment updated",
        "tags": [
          "Comment webhooks"
        ]
      }
    },
    "dataSourceContentUpdated": {
      "post": {
        "description": "Webhook event for data source content updated in a workspace",
        "operationId": "webhook-data-source-content-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceContentUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source content updated",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "dataSourceCreated": {
      "post": {
        "description": "Webhook event for data source created in a workspace",
        "operationId": "webhook-data-source-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source created",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "dataSourceDeleted": {
      "post": {
        "description": "Webhook event for data source deleted in a workspace",
        "operationId": "webhook-data-source-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source deleted",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "dataSourceMoved": {
      "post": {
        "description": "Webhook event for data source moved in a workspace",
        "operationId": "webhook-data-source-moved",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceMovedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source moved",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "dataSourceSchemaUpdated": {
      "post": {
        "description": "Webhook event for data source schema updated in a workspace",
        "operationId": "webhook-data-source-schema-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceSchemaUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source schema updated",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "dataSourceUndeleted": {
      "post": {
        "description": "Webhook event for data source undeleted in a workspace",
        "operationId": "webhook-data-source-undeleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dataSourceUndeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Data source undeleted",
        "tags": [
          "Data source webhooks"
        ]
      }
    },
    "databaseContentUpdated": {
      "post": {
        "description": "Webhook event for database content updated in a workspace",
        "operationId": "webhook-database-content-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseContentUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database content updated",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "databaseCreated": {
      "post": {
        "description": "Webhook event for database created in a workspace",
        "operationId": "webhook-database-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database created",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "databaseDeleted": {
      "post": {
        "description": "Webhook event for database deleted in a workspace",
        "operationId": "webhook-database-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database deleted",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "databaseMoved": {
      "post": {
        "description": "Webhook event for database moved in a workspace",
        "operationId": "webhook-database-moved",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseMovedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database moved",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "databaseSchemaUpdated": {
      "post": {
        "description": "Webhook event for database schema updated in a workspace",
        "operationId": "webhook-database-schema-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseSchemaUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database schema updated",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "databaseUndeleted": {
      "post": {
        "description": "Webhook event for database undeleted in a workspace",
        "operationId": "webhook-database-undeleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/databaseUndeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Database undeleted",
        "tags": [
          "Database webhooks"
        ]
      }
    },
    "fileUploadCompleted": {
      "post": {
        "description": "Webhook event for file upload completed in a workspace",
        "operationId": "webhook-file-upload-completed",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/fileUploadCompletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "File upload completed",
        "tags": [
          "File upload webhooks"
        ]
      }
    },
    "fileUploadCreated": {
      "post": {
        "description": "Webhook event for file upload created in a workspace",
        "operationId": "webhook-file-upload-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/fileUploadCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "File upload created",
        "tags": [
          "File upload webhooks"
        ]
      }
    },
    "fileUploadExpired": {
      "post": {
        "description": "Webhook event for file upload expired in a workspace",
        "operationId": "webhook-file-upload-expired",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/fileUploadExpiredWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "File upload expired",
        "tags": [
          "File upload webhooks"
        ]
      }
    },
    "fileUploadUploadFailed": {
      "post": {
        "description": "Webhook event for file upload upload failed in a workspace",
        "operationId": "webhook-file-upload-upload-failed",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/fileUploadUploadFailedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "File upload failed",
        "tags": [
          "File upload webhooks"
        ]
      }
    },
    "pageContentUpdated": {
      "post": {
        "description": "Webhook event for page content updated in a workspace",
        "operationId": "webhook-page-content-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageContentUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page content updated",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageCreated": {
      "post": {
        "description": "Webhook event for page created in a workspace",
        "operationId": "webhook-page-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page created",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageDeleted": {
      "post": {
        "description": "Webhook event for page deleted in a workspace",
        "operationId": "webhook-page-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page deleted",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageLocked": {
      "post": {
        "description": "Webhook event for page locked in a workspace",
        "operationId": "webhook-page-locked",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageLockedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page locked",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageMoved": {
      "post": {
        "description": "Webhook event for page moved in a workspace",
        "operationId": "webhook-page-moved",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageMovedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page moved",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pagePropertiesUpdated": {
      "post": {
        "description": "Webhook event for page properties updated in a workspace",
        "operationId": "webhook-page-properties-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pagePropertiesUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page properties updated",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageTranscriptionBlockTranscriptDeleted": {
      "post": {
        "description": "Webhook event for transcript deletion in a page's transcription block",
        "operationId": "webhook-page-transcription-block-transcript-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageTranscriptionBlockTranscriptDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page transcript deleted",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageUndeleted": {
      "post": {
        "description": "Webhook event for page undeleted in a workspace",
        "operationId": "webhook-page-undeleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageUndeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page undeleted",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "pageUnlocked": {
      "post": {
        "description": "Webhook event for page unlocked in a workspace",
        "operationId": "webhook-page-unlocked",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/pageUnlockedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "Page unlocked",
        "tags": [
          "Page webhooks"
        ]
      }
    },
    "viewCreated": {
      "post": {
        "description": "Webhook event for a database view created in a workspace",
        "operationId": "webhook-view-created",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/viewCreatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "View created",
        "tags": [
          "View webhooks"
        ]
      }
    },
    "viewDeleted": {
      "post": {
        "description": "Webhook event for a database view deleted in a workspace",
        "operationId": "webhook-view-deleted",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/viewDeletedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "View deleted",
        "tags": [
          "View webhooks"
        ]
      }
    },
    "viewUpdated": {
      "post": {
        "description": "Webhook event for a database view updated in a workspace",
        "operationId": "webhook-view-updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/viewUpdatedWebhookPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return an HTTP 200 status code to indicate that the data was received successfully."
          }
        },
        "security": [],
        "summary": "View updated",
        "tags": [
          "View webhooks"
        ]
      }
    }
  }
}
