bldinit Notion Rest API

The notion-rest API from bldinit — 12 operation(s) for notion-rest.

GitHub OpenAPI

Operations 17

GET /api/v1/notion/v1/users/me Retrieve the integration bot user (read) #
GET /api/v1/notion/v1/users List workspace users (read) #
POST /api/v1/notion/v1/databases Create a new database with an initial schema (write) ⭐ #
GET /api/v1/notion/v1/databases/{database_id} Retrieve database metadata + data_sources list (read) #
GET /api/v1/notion/v1/data_sources/{data_source_id} Retrieve data source schema (read) #
POST /api/v1/notion/v1/data_sources/{data_source_id}/query Query pages in a data source with filter + sort (read) ⭐ #
GET /api/v1/notion/v1/pages/{page_id} Retrieve page metadata + properties (read) #
PATCH /api/v1/notion/v1/pages/{page_id} Update page properties / archive (write) #
POST /api/v1/notion/v1/pages Create a new page (write) #
GET /api/v1/notion/v1/blocks/{block_id} Retrieve a single block (read) #
PATCH /api/v1/notion/v1/blocks/{block_id} Update a block's content (write) #
DELETE /api/v1/notion/v1/blocks/{block_id} Delete a block (destructive — ADR-030 confirmation required) ⚠ #
GET /api/v1/notion/v1/blocks/{block_id}/children List a block's children (read) #
PATCH /api/v1/notion/v1/blocks/{block_id}/children Append blocks to a block's children (write) #
GET /api/v1/notion/v1/comments List comments on a block or page (read) #
POST /api/v1/notion/v1/comments Create a comment (write) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-notion-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-notion-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Notion Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: notion-rest
paths:
  /api/v1/notion/v1/search:
    post:
      tags:
      - notion-rest
      summary: Search pages and data sources by title (read)
      description: 'Per-integration scope — install 시점에 user 가 share 한 페이지만

        검색 가능. **title 만 검색** (block content 검색 불가).


        ``filter.value`` 로 page / data_source 분리. ``sort`` 는

        last_edited_time 만 지원.


        Response schema 안내: 각 result item 의 ``object`` field 가

        "page" / "data_source" 를 명시. top-level 의 ``type:

        "page_or_data_source"`` + 빈 ``page_or_data_source: {}`` field 는

        Notion API 의 internal discriminator 부산물 — 무시.


        > Notion docs: developers.notion.com/reference/post-search'
      operationId: notion_search
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/users/me:
    get:
      tags:
      - notion-rest
      summary: Retrieve the integration bot user (read)
      description: 'mcpweave 가 install 된 connection 의 bot user object 반환. ``bot.owner``

        에 OAuth 권한 부여한 사용자 정보 동봉.


        > read_user_* capability 필요.


        > Notion docs: developers.notion.com/reference/get-self'
      operationId: notion_retrieve_user_me
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/users:
    get:
      tags:
      - notion-rest
      summary: List workspace users (read)
      description: 'Workspace 내 모든 user (person + bot). Cursor pagination.


        > read_user_* capability 필요. ``read_user_with_email`` 보유 시

        > ``person.email`` 노출, 그렇지 않으면 email 누락.


        > Notion docs: developers.notion.com/reference/get-users'
      operationId: notion_list_users
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/databases:
    post:
      tags:
      - notion-rest
      summary: Create a new database with an initial schema (write) ⭐
      description: '페이지 하위에 **새 database(표) 를 스키마째 생성**. 빈 노션에서

        AI 가 DB 구조까지 만들 때 사용 (그 뒤 notion_create_page 로 행 채움).


        ⚠ **2025-09-03 모델**: property schema 는 top-level 이 아니라

        ``initial_data_source.properties`` 아래로 들어간다. (구버전 top-level

        ``properties`` 는 deprecated.) 생성 응답의 ``data_sources[0].id`` 가

        이후 query/page 생성에 쓰는 data_source_id.


        - ``parent``: ``{type:"page_id", page_id:""}`` (권장) 또는

        ``{type:"workspace", workspace:true}`` (Public OAuth 전용).

        - ``title``: rich text array (DB 이름).

        - ``initial_data_source.properties``: 열 정의. 정확히 하나의 열은

        ``{"title": {}}`` (제목 열) 이어야 함. 예:

        ``{"이름": {"title": {}}, "상태": {"select": {"options": [{"name":"진행중"}]}},

        "매출": {"number": {"format": "won"}}, "날짜": {"date": {}}}`` (24 property type).


        > Notion docs: developers.notion.com/reference/create-a-database'
      operationId: notion_create_database
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/databases/{database_id}:
    get:
      tags:
      - notion-rest
      summary: Retrieve database metadata + data_sources list (read)
      description: 'Database metadata + data_sources list. Use data_sources[0].id for

        query (notion_query_data_source). Wiki database may have multiple

        data_sources.


        > Notion docs: developers.notion.com/reference/retrieve-a-database'
      operationId: notion_retrieve_database
      parameters:
      - name: database_id
        in: path
        required: true
        schema:
          type: string
          title: Database Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/data_sources/{data_source_id}:
    get:
      tags:
      - notion-rest
      summary: Retrieve data source schema (read)
      description: 'Data source 자체 metadata (property schema, name). database 의

        sub-entity.


        > Notion docs: developers.notion.com/reference/retrieve-a-data-source'
      operationId: notion_retrieve_data_source
      parameters:
      - name: data_source_id
        in: path
        required: true
        schema:
          type: string
          title: Data Source Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/data_sources/{data_source_id}/query:
    post:
      tags:
      - notion-rest
      summary: Query pages in a data source with filter + sort (read) ⭐
      description: 'Phase 1 의 핵심 read op — database 안의 page 들을 filter + sort 로 조회.


        ⚠ **ID 주의**: ``database_id`` 가 아닌 ``data_source_id`` 사용. 먼저

        ``notion_retrieve_database`` 호출 후 응답의 ``data_sources[0].id`` 를

        그대로 query 에 사용. (Wiki database 의 경우 여러 data source 가

        있을 수 있으니 의도에 맞는 source 선택.)


        Filter shape (14 property type 별 operator 차이) — research note

        01-data-model §3-D 참조.


        응답에 ``request_status.type=incomplete`` 시 Notion 측 query timeout —

        filter 좁히거나 sort 명시 권장.


        > Notion docs: developers.notion.com/reference/query-a-data-source'
      operationId: notion_query_data_source
      parameters:
      - name: data_source_id
        in: path
        required: true
        schema:
          type: string
          title: Data Source Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/pages/{page_id}:
    get:
      tags:
      - notion-rest
      summary: Retrieve page metadata + properties (read)
      description: '페이지 자체 (title + properties + icon/cover/url) 반환. ⚠ Page content

        (block tree) 는 별도 호출 필요 — ``notion_retrieve_block_children``

        with ``block_id = page_id``.


        > Notion docs: developers.notion.com/reference/retrieve-a-page'
      operationId: notion_retrieve_page
      parameters:
      - name: page_id
        in: path
        required: true
        schema:
          type: string
          title: Page Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: filter_properties
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Filter Properties
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - notion-rest
      summary: Update page properties / archive (write)
      description: '페이지의 properties 부분 update. Partial update — body 에 보낸

        property 만 변경되고 다른 property 는 유지.


        - Database parent page: body 의 property key 는 parent schema 의

        property name 또는 id

        - Page parent: ``title`` property 만 valid


        Icon / cover 도 동시 변경 가능 (optional).


        ADR-028 §D2-B **recoverable** — Notion UI 의 page history 로 복구

        가능. Confirmation token 불필요.


        **Archive 도 같은 endpoint 사용** (ADR-054 D14 amendment): body 에

        ``in_trash: true`` (또는 deprecated ``archived: true``) 명시 시

        페이지를 휴지통으로 이동. Notion UI 의 30일 retention 으로 restore

        가능 — Notion 의 user 표준 패턴이라 별도 archive tool 분리 안 함.


        > Notion docs: developers.notion.com/reference/patch-page'
      operationId: notion_update_page_properties
      parameters:
      - name: page_id
        in: path
        required: true
        schema:
          type: string
          title: Page Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/pages:
    post:
      tags:
      - notion-rest
      summary: Create a new page (write)
      description: '새 페이지 생성. ``parent.type`` 에 따라 properties 제약 다름:

        - ``data_source_id`` (권장, 2025-09-03+): parent schema 모두 채워야 함

        - ``database_id`` (호환): 동일 (자동으로 default data_source 사용)

        - ``page_id``: ``title`` property 만 valid

        - ``workspace`` (Public OAuth 전용): top-level page


        ``children`` 으로 초기 block 100개 까지 동시 insert (template 사용 시

        children 금지).


        > Notion docs: developers.notion.com/reference/post-page'
      operationId: notion_create_page
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/blocks/{block_id}:
    get:
      tags:
      - notion-rest
      summary: Retrieve a single block (read)
      description: '단일 block 의 metadata + type-specific payload 반환. 페이지 root 도

        block 으로 retrieve 가능 (block_id = page_id).


        > Notion docs: developers.notion.com/reference/retrieve-a-block'
      operationId: notion_retrieve_block
      parameters:
      - name: block_id
        in: path
        required: true
        schema:
          type: string
          title: Block Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - notion-rest
      summary: Update a block's content (write)
      description: 'Block 의 type-specific payload (rich_text / properties) update. block

        type 자체 변경 불가 — 같은 type 안에서 content 만.


        ADR-028 §D2-B **recoverable** — Notion UI 의 page history 로 복구 가능.

        Confirmation token 불필요.


        body 예 (paragraph 의 텍스트 교체):

        ```

        {"paragraph": {"rich_text": [{"type":"text", "text":{"content":"new"}}]}}

        ```


        > Notion docs: developers.notion.com/reference/update-a-block'
      operationId: notion_update_block
      parameters:
      - name: block_id
        in: path
        required: true
        schema:
          type: string
          title: Block Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    delete:
      tags:
      - notion-rest
      summary: Delete a block (destructive — ADR-030 confirmation required) ⚠
      description: 'Block 을 trash 로 이동 (즉시 사라짐). Restore 는 Notion UI 의 page

        history 에서만 가능. **ADR-028/030 destructive op confirmation token

        필수** — first call 시 token 발급, 두 번째 call 시 token 포함하면 실행.


        > Notion docs: developers.notion.com/reference/delete-a-block'
      operationId: notion_delete_block
      parameters:
      - name: block_id
        in: path
        required: true
        schema:
          type: string
          title: Block Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/blocks/{block_id}/children:
    get:
      tags:
      - notion-rest
      summary: List a block's children (read)
      description: 'Block 의 직속 children 1-level 만 반환. Nested block (has_children=true)

        은 caller (LLM) 가 재귀 호출 필요.


        Cursor pagination — large page 는 multiple 호출.


        > Notion docs: developers.notion.com/reference/get-block-children'
      operationId: notion_retrieve_block_children
      parameters:
      - name: block_id
        in: path
        required: true
        schema:
          type: string
          title: Block Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - notion-rest
      summary: Append blocks to a block's children (write)
      description: 'Block 의 children 끝 (또는 ``position.start`` / ``after_block``) 에 새

        block 100개 까지 동시 insert. 페이지 root 에도 append 가능

        (block_id = page_id).


        > Notion docs: developers.notion.com/reference/patch-block-children'
      operationId: notion_append_block_children
      parameters:
      - name: block_id
        in: path
        required: true
        schema:
          type: string
          title: Block Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/notion/v1/comments:
    get:
      tags:
      - notion-rest
      summary: List comments on a block or page (read)
      description: 'Page / block 에 달린 코멘트 thread 들 반환. ⚠ **unresolved comment 만**

        반환 — resolved 된 thread 는 list 에서 제외.


        Cursor pagination.


        > read_comments capability 필요.

        > Notion docs: developers.notion.com/reference/retrieve-a-comment'
      operationId: notion_list_comments
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: block_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Block Id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - notion-rest
      summary: Create a comment (write)
      description: '새 thread 시작 또는 기존 thread 에 reply.


        - 새 thread: ``parent`` 필수 (page_id 또는 block_id). 응답에 ``discussion_id`` 신규 발급.

        - Reply: ``discussion_id`` 만 명시 (parent 없음).


        ``rich_text`` 와 ``markdown`` 중 **정확히 하나** (Notion 측에서 markdown 을 parsing).


        > insert_comments capability 필요.

        > Notion docs: developers.notion.com/reference/create-a-comment'
      operationId: notion_create_comment
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)