> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Sync pages, databases, and users from Notion

Sync pages, databases, and users from Notion.

<Tabs>
  <Tab title="Overview">
    Connect Parable to Notion via an internal connection for access to pages, databases, and workspace data.

    #### Pages & Databases

    Page content, database records, properties

    #### Users

    Workspace members and collaborators

    ## Data streams

    This Provider Plugin defines 6 data streams.

    | Stream           | Description                        | Sync        |
    | ---------------- | ---------------------------------- | ----------- |
    | `users`          | Workspace users                    | full        |
    | `databases`      | Databases in the workspace         | incremental |
    | `database_items` | Items (pages) within a data source | incremental |
    | `pages`          | Pages in the workspace             | incremental |
    | `blocks`         | Block children of a page           | full        |
    | `comments`       | Comments on a page or block        | full        |
  </Tab>

  <Tab title="Setup Guide">
    ### API token

    #### What You'll Need

    | Credential | What it is                |
    | ---------- | ------------------------- |
    | **Token**  | Internal connection token |

    > **Info:** **Setup access in Notion.** These steps require **Administrator**, or a colleague with equivalent permissions who can create credentials for you.
    >
    > If that is not you, ask your Notion administrator.

    * **Workspace Owner** or **Admin** role
    * Pages/databases must be explicitly shared with the connection

    #### Step 1: Create Connection

    1. Go to <a href="https://www.notion.so/profile/integrations/internal" target="_blank" rel="noopener noreferrer">Notion Creator Dashboard</a>
    2. Click **Create a new connection**
    3. Fill in:

    | Field                | Value                                                     |
    | -------------------- | --------------------------------------------------------- |
    | Name                 | `Parable` (Notion rejects names containing "Integration") |
    | Associated workspace | Select your workspace                                     |
    | Logo                 | Optional                                                  |
    | Type                 | Internal                                                  |

    #### Step 2: Configure Capabilities

    Under **Configuration** > **Capabilities**, enable:

    | Capability            | Setting             |
    | --------------------- | ------------------- |
    | Read content          | ✅                   |
    | Update content        | ❌ (not needed)      |
    | Insert content        | ❌ (not needed)      |
    | Read comments         | ✅                   |
    | Read user information | ✅ (including email) |

    #### Step 3: Copy Token

    1. Click **Show** next to the internal integration secret
    2. Copy the token

    > **Warning:** **Copy your token now!**
    >
    > This is the only time it will be displayed. Store it in a secure password manager before closing this page.

    #### Step 4: Share Content with Connection

    The connection can only access pages and databases you explicitly share with it. You need to share each top-level page or database that contains data you want Parable to sync.

    For each top-level page or database:

    1. Open it in Notion
    2. Click **•••** (three dots) menu in the top right
    3. Click **Add connections**
    4. Search for and select **Parable**

    > **Tip:** Child pages automatically inherit access from their parent. Share at the highest level that covers the content you need -- for example, sharing a team workspace page gives the connection access to all pages nested underneath it.

    > **Warning:** Any page or database not explicitly shared (or nested under a shared parent) will be invisible to the connection.

    #### Step 5: Enter values in the form

    1. **Token**: Paste your Notion internal connection token.
    2. Click **Save & test connection**.

    ```bash List Users theme={null}
    curl -X GET "https://api.notion.com/v1/users" \
      -H "Authorization: Bearer YOUR_TOKEN" \
      -H "Notion-Version: 2026-03-11"
    ```

    ```bash Search Content theme={null}
    curl -X POST "https://api.notion.com/v1/search" \
      -H "Authorization: Bearer YOUR_TOKEN" \
      -H "Notion-Version: 2026-03-11" \
      -H "Content-Type: application/json" \
      -d '{"page_size": 5}'
    ```

    > **Success:** **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now configure this Provider in Parable.

    > **Tip:** **Rate Limits:** Notion enforces rate limits of **3 requests/second average with bursts allowed**.
    >
    > Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
  </Tab>

  <Tab title="Permissions">
    <AccordionGroup>
      <Accordion id="provider-permission-tap-notion-blocks-6c24de63ef17" title="Blocks" icon="route" iconType="sharp-duotone-solid">
        Developer identifier: `blocks`

        **Blocks.** Block children of a page.

        * **Enables:** Reconstruct visible Notion page content from ordered block records and their nested rich-text fragments.
        * **Scope:** Reads the records selected by Notion's `/v1/blocks/{id}/children` operation as a snapshot stream using full synchronization. This stream is opt-in. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. Rich-text and block payloads represent content visible to the integration; external or uploaded file bytes are not fetched. Removal is recognized from the provider's tombstone state rather than absence alone.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-blocks-archived-dd5c1048fcc4" title="Archived" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.archived`

            **Archived.** Whether the block has been archived (deleted). It distinguishes the provider-defined archived state or classification for the block.

            * **Enables:** Filter Blocks by whether the block has been archived (deleted) in `blocks.archived`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the block has been archived (deleted) as a boolean on each block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-7fcf8353f610" title="Audio" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio`

            **Audio.** Audio block content. Present when type is 'audio'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute audio in `blocks.audio` to the parent block; identify parent records where that nested audio object is absent.
            * **Interpretation:** Notion reports audio as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-af890355381b" title="Caption" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption`

            **Caption.** Caption for the file. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned caption content in `blocks.FileBlock.caption` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns caption as ordered content or provider-generated content metadata on each file block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-7a8c79e264ed" title="Annotations" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations`

            **Annotations.** Styling annotations for the rich text. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute annotations in `blocks.RichTextObject.annotations` to the parent block; identify parent records where that nested annotations object is absent.
            * **Interpretation:** Notion reports annotations as a nested object on each rich text object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-bold-6e7d2e78ebcc" title="Bold" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.bold`

            **Bold.** Whether the text is bold. It distinguishes the provider-defined bold state or classification for the annotation.

            * **Enables:** Filter Blocks by whether the text is bold in `blocks.Annotations.bold`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is bold as a boolean on each annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-code-47a4a41d2042" title="Code" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.code`

            **Code.** Whether the text is displayed as inline code. It distinguishes the provider-defined code state or classification for the annotation.

            * **Enables:** Filter Blocks by whether the text is displayed as inline code in `blocks.Annotations.code`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is displayed as inline code as a boolean on each annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-color-9018938d521f" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.color`

            **Color.** Text color or background color (e.g., 'default', 'red', 'blue\_background'). It supplies the returned color text needed to understand the annotation in context.

            * **Enables:** Search the returned color text in `blocks.Annotations.color` and attribute each match to its parent block and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each annotation; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-italic-63843fa34804" title="Italic" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.italic`

            **Italic.** Whether the text is italic. It distinguishes the provider-defined italic state or classification for the annotation.

            * **Enables:** Filter Blocks by whether the text is italic in `blocks.Annotations.italic`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is italic as a boolean on each annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-striketh-f6f9345d08ca" title="Strikethrough" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.strikethrough`

            **Strikethrough.** Whether the text has strikethrough. It distinguishes the provider-defined strikethrough state or classification for the annotation.

            * **Enables:** Filter Blocks by whether the text has strikethrough in `blocks.Annotations.strikethrough`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text has strikethrough as a boolean on each annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-annotations-underlin-785dd9a97644" title="Underline" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.annotations.underline`

            **Underline.** Whether the text is underlined. It distinguishes the provider-defined underline state or classification for the annotation.

            * **Enables:** Filter Blocks by whether the text is underlined in `blocks.Annotations.underline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is underlined as a boolean on each annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-equation-908cf8141749" title="Equation" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.equation`

            **Equation.** Equation content. Present when type is 'equation'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute equation in `blocks.RichTextObject.equation` to the parent block; identify parent records where that nested equation object is absent.
            * **Interpretation:** Notion reports equation as a nested object on each rich text object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-equation-expression-d5b0110eda27" title="Expression" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.equation.expression`

            **Expression.** The LaTeX/KaTeX expression. It must be interpreted with the enclosing provider field name, type, or custom schema for the equation content.

            * **Enables:** Interpret `blocks.EquationContent.expression` with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
            * **Interpretation:** Notion reports expression under the enclosing custom or typed field contract on each equation content; compare it only with values from the same provider key and type.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-href-f212c5e727b6" title="Href" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.href`

            **Href.** URL link if the text is a link. It locates the provider resource or path associated with the rich text object.

            * **Enables:** Associate each rich text object with the resource identified by href in `blocks.RichTextObject.href`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports href as a resource locator for each rich text object; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-df981aaabb38" title="Mention" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention`

            **Mention.** Mention content. Present when type is 'mention'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute mention in `blocks.RichTextObject.mention` to the parent block; identify parent records where that nested mention object is absent.
            * **Interpretation:** Notion reports mention as a nested object on each rich text object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-database-a30d642a2dec" title="Database" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.database`

            **Database.** Database mention. Present when type is 'database'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute database in `blocks.MentionContent.database` to the parent block; identify parent records where that nested database object is absent.
            * **Interpretation:** Notion reports database as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-database-id-6f12ff90dba2" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.database.id`

            **ID.** The UUID of the referenced object. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each ID reference in Blocks to the referenced ID reference through `blocks.IdReference.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its ID reference namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-date-28071186bb26" title="Date" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.date`

            **Date.** Date mention. Present when type is 'date'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute date in `blocks.MentionContent.date` to the parent block; identify parent records where that nested date object is absent.
            * **Interpretation:** Notion reports date as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-date-end-136546283417" title="End" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.date.end`

            **End.** End date or datetime in ISO 8601 format, null for single dates. It anchors the block on the provider's reported timeline.

            * **Enables:** Filter Blocks by end in `blocks.DateValue.end`; pair that boundary with the corresponding start before measuring elapsed time.
            * **Interpretation:** Notion reports end as a timestamp on each date value; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-date-start-4daa38e633d0" title="Start" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.date.start`

            **Start.** Start date or datetime in ISO 8601 format. It anchors the block on the provider's reported timeline.

            * **Enables:** Filter Blocks by start in `blocks.DateValue.start`; pair that boundary with the corresponding end before measuring elapsed time.
            * **Interpretation:** Notion reports start as a timestamp on each date value; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-date-time-zo-ec563841404d" title="Time Zone" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.date.time_zone`

            **Time Zone.** IANA time zone identifier if the date includes a time. It is needed to interpret companion dates and times for the date value in the provider's intended zone.

            * **Enables:** Apply the zone in `blocks.DateValue.time_zone` when converting the block's companion start, end, or scheduled timestamps; do not infer it from locale.
            * **Interpretation:** Notion reports time zone as a timezone identifier for each date value; supported IANA or provider-specific names and daylight-saving behavior must be preserved.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-link-preview-4b87b3c5fc6a" title="Link Preview" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.link_preview`

            **Link Preview.** Link preview mention. Present when type is 'link\_preview'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute link preview in `blocks.MentionContent.link_preview` to the parent block; identify parent records where that nested link preview object is absent.
            * **Interpretation:** Notion reports link preview as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-link-preview-242e3359c541" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.link_preview.url`

            **URL.** The URL being previewed. It locates the provider resource or path associated with the link preview content.

            * **Enables:** Associate each link preview content with the resource identified by URL in `blocks.LinkPreviewContent.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each link preview content; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-page-6eb063a80aae" title="Page" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.page`

            **Page.** Page mention. Present when type is 'page'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute page in `blocks.MentionContent.page` to the parent block; identify parent records where that nested page object is absent.
            * **Interpretation:** Notion reports page as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-template-men-b9b5aaa133e0" title="Template Mention" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.template_mention`

            **Template Mention.** Template mention data. Present when type is 'template\_mention'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute template mention in `blocks.MentionContent.template_mention` to the parent block; identify parent records where that nested template mention object is absent.
            * **Interpretation:** Notion reports template mention as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-type-89e3615c9a03" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.type`

            **Type.** The type of mention (user, page, database, date, link\_preview, template\_mention). It distinguishes the provider-defined type state or classification for the mention content.

            * **Enables:** Segment mention content entries in Blocks by type in `blocks.MentionContent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each mention content; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-user-a906fcead16f" title="User" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.user`

            **User.** User mention. Present when type is 'user'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute user in `blocks.MentionContent.user` to the parent block; identify parent records where that nested user object is absent.
            * **Interpretation:** Notion reports user as a nested object on each mention content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-user-id-81d75bdc027b" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.user.id`

            **ID.** UUID of the user. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each partial user in Blocks to the referenced partial user through `blocks.PartialUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its partial user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-mention-user-object-cfd75f5d0174" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.mention.user.object`

            **Object.** Always 'user' for user objects. It distinguishes the provider-defined object state or classification for the partial user.

            * **Enables:** Filter Blocks by the exact Notion-defined object in `blocks.PartialUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each partial user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-plain-text-9715a29894ae" title="Plain Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.plain_text`

            **Plain Text.** Plain text representation without annotations. It defines the content surface available for this block.

            * **Enables:** Locate rich text object records by plain text in `blocks.RichTextObject.plain_text`; attribute each text match to its parent block and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-text-009d48deae52" title="Text" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.text`

            **Text.** Text content. Present when type is 'text'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute text in `blocks.RichTextObject.text` to the parent block; identify parent records where that nested text object is absent.
            * **Interpretation:** Notion reports text as a nested object on each rich text object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-text-content-d07e09bda990" title="Content" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.text.content`

            **Content.** The actual text content. It defines the content surface available for this block.

            * **Enables:** Locate text content records by content in `blocks.TextContent.content`; attribute each text match to its parent block and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-text-link-471a7ab209f9" title="Link" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.text.link`

            **Link.** Optional link object if the text is a hyperlink. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute link in `blocks.TextContent.link` to the parent block; identify parent records where that nested link object is absent.
            * **Interpretation:** Notion reports link as a nested object on each text content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-text-link-url-b1e7782e66bf" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.text.link.url`

            **URL.** The URL the text links to. It locates the provider resource or path associated with the link object.

            * **Enables:** Associate each link object with the resource identified by URL in `blocks.LinkObject.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each link object; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-caption-type-037711e7e8ec" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.caption.type`

            **Type.** The type of rich text (text, mention, equation). It distinguishes the provider-defined type state or classification for the rich text object.

            * **Enables:** Segment rich text object entries in Blocks by type in `blocks.RichTextObject.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each rich text object; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-external-d937f4f88fb0" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.external`

            **External.** External file details. Present when type is 'external'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute external in `blocks.FileBlock.external` to the parent block; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each file block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-external-url-2a87dd69ff6b" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.external.url`

            **URL.** URL of the external file. It locates the provider resource or path associated with the external file.

            * **Enables:** Associate each external file with the resource identified by URL in `blocks.ExternalFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each external file; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-file-57d1a4059280" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.file`

            **File.** Notion-hosted file details. Present when type is 'file'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute file in `blocks.FileBlock.file` to the parent block; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each file block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-file-expiry-time-0c97b70a8292" title="Expiry Time" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.file.expiry_time`

            **Expiry Time.** ISO 8601 expiration time for the temporary URL. It anchors the block on the provider's reported timeline.

            * **Enables:** Order Blocks by expiry time in `blocks.NotionHostedFile.expiry_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports expiry time as a timestamp on each Notion hosted file; timezone and precision follow this API field, and absence is not an inferred event time. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-file-url-4bcfde5ac724" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.file.url`

            **URL.** Temporary authenticated URL for the Notion-hosted file. It locates the provider resource or path associated with the Notion hosted file.

            * **Enables:** Associate each Notion hosted file with the resource identified by URL in `blocks.NotionHostedFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion hosted file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-name-2ef532b06ffb" title="Name" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.name`

            **Name.** Name of the file. It gives the file block a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each file block with name from `blocks.FileBlock.name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports name as display text for each file block; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-audio-type-589eccc78308" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.audio.type`

            **Type.** Whether the file is hosted by Notion ('file') or externally ('external'). It distinguishes the provider-defined type state or classification for the file block.

            * **Enables:** Segment file block entries in Blocks by type in `blocks.FileBlock.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each file block; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bookmark-6f6d105a39a0" title="Bookmark" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bookmark`

            **Bookmark.** Bookmark block content. Present when type is 'bookmark'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute bookmark in `blocks.bookmark` to the parent block; identify parent records where that nested bookmark object is absent.
            * **Interpretation:** Notion reports bookmark as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bookmark-caption-159424f225e8" title="Caption" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bookmark.caption`

            **Caption.** Caption for the bookmark. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned caption content in `blocks.BookmarkBlock.caption` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns caption as ordered content or provider-generated content metadata on each bookmark block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bookmark-url-5709b931da08" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bookmark.url`

            **URL.** The bookmarked URL. It locates the provider resource or path associated with the bookmark block.

            * **Enables:** Associate each bookmark block with the resource identified by URL in `blocks.BookmarkBlock.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each bookmark block; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-breadcrumb-c4cb967149a4" title="Breadcrumb" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.breadcrumb`

            **Breadcrumb.** Breadcrumb block content. Present when type is 'breadcrumb'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute breadcrumb in `blocks.breadcrumb` to the parent block; identify parent records where that nested breadcrumb object is absent.
            * **Interpretation:** Notion reports breadcrumb as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bulleted-list-item-4bbe81c88710" title="Bulleted List Item" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bulleted_list_item`

            **Bulleted List Item.** Bulleted list item content. Present when type is 'bulleted\_list\_item'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute bulleted list item in `blocks.bulleted_list_item` to the parent block; identify parent records where that nested bulleted list item object is absent.
            * **Interpretation:** Notion reports bulleted list item as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bulleted-list-item-color-94475f31b9d3" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bulleted_list_item.color`

            **Color.** Color of the block text or background. It supplies the returned color text needed to understand the rich text block in context.

            * **Enables:** Search the returned color text in `blocks.RichTextBlock.color` and attribute each match to its parent block and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each rich text block; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-bulleted-list-item-rich-text-53e34a8d1689" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.bulleted_list_item.rich_text`

            **Rich Text.** Array of rich text objects forming the block content. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned rich text content in `blocks.RichTextBlock.rich_text` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each rich text block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-a99d7009d31d" title="Callout" icon="video" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout`

            **Callout.** Callout block content. Present when type is 'callout'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute callout in `blocks.callout` to the parent block; identify parent records where that nested callout object is absent.
            * **Interpretation:** Notion reports callout as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-color-bddb6db5a9f3" title="Color" icon="video" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.color`

            **Color.** Color of the callout background. It distinguishes the provider-defined color state or classification for the callout block.

            * **Enables:** Filter Blocks by the exact Notion-defined color in `blocks.CalloutBlock.color` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies color from its own taxonomy on each callout block; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-icon-998138131c9b" title="Icon" icon="video" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.icon`

            **Icon.** The icon displayed in the callout. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute icon in `blocks.CalloutBlock.icon` to the parent block; identify parent records where that nested icon object is absent.
            * **Interpretation:** Notion reports icon as a nested object on each callout block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-icon-emoji-001bc18f5ac1" title="Emoji" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.icon.emoji`

            **Emoji.** The emoji character. Present when type is 'emoji'. It distinguishes the provider-defined emoji state or classification for the icon object.

            * **Enables:** Filter Blocks by the exact Notion-defined emoji in `blocks.IconObject.emoji` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies emoji from its own taxonomy on each icon object; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-icon-external-e53eff983b18" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.icon.external`

            **External.** External file reference. Present when type is 'external'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute external in `blocks.IconObject.external` to the parent block; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each icon object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-icon-type-ace12bccf217" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.icon.type`

            **Type.** The type of icon ('emoji' or 'external'). It distinguishes the provider-defined type state or classification for the icon object.

            * **Enables:** Segment icon object entries in Blocks by type in `blocks.IconObject.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each icon object; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-callout-rich-text-a0dfd53d2205" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.callout.rich_text`

            **Rich Text.** Array of rich text objects forming the callout content. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned rich text content in `blocks.CalloutBlock.rich_text` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each callout block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-child-database-2200fe4c99df" title="Child Database" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.child_database`

            **Child Database.** Child database block content. Present when type is 'child\_database'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute child database in `blocks.child_database` to the parent block; identify parent records where that nested child database object is absent.
            * **Interpretation:** Notion reports child database as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-child-database-title-a79a5668aa1f" title="Title" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.child_database.title`

            **Title.** The title of the child database. It gives the child database block a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each child database block with title from `blocks.ChildDatabaseBlock.title`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports title as display text for each child database block; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-child-page-5390722ab49a" title="Child Page" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.child_page`

            **Child Page.** Child page block content. Present when type is 'child\_page'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute child page in `blocks.child_page` to the parent block; identify parent records where that nested child page object is absent.
            * **Interpretation:** Notion reports child page as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-child-page-title-3f8097bc9019" title="Title" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.child_page.title`

            **Title.** The title of the child page. It gives the child page block a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each child page block with title from `blocks.ChildPageBlock.title`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports title as display text for each child page block; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-code-284e2f6335b7" title="Code" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.code`

            **Code.** Code block content. Present when type is 'code'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute code in `blocks.code` to the parent block; identify parent records where that nested code object is absent.
            * **Interpretation:** Notion reports code as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-code-caption-ac4b32cc16c8" title="Caption" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.code.caption`

            **Caption.** Caption for the code block. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned caption content in `blocks.CodeBlock.caption` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns caption as ordered content or provider-generated content metadata on each code block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-code-language-f2ce7c54adab" title="Language" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.code.language`

            **Language.** Programming language of the code block (e.g., 'javascript', 'python'). It supplies the language profile facet used to reconcile or attribute the code block.

            * **Enables:** Reconcile the block's language in `blocks.CodeBlock.language` with its provider profile or directory identity; confirm ambiguous matches with the stable provider ID.
            * **Interpretation:** Notion reports language as a mutable profile or directory attribute on each code block; it may be absent, shared, or non-unique.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-code-rich-text-d33ebb26d1fb" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.code.rich_text`

            **Rich Text.** Array of rich text objects forming the code content. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned rich text content in `blocks.CodeBlock.rich_text` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each code block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-column-5284967bcd0b" title="Column" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.column`

            **Column.** Column block content. Present when type is 'column'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute column in `blocks.column` to the parent block; identify parent records where that nested column object is absent.
            * **Interpretation:** Notion reports column as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-column-list-1331f33b032a" title="Column List" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.column_list`

            **Column List.** Column list block content. Present when type is 'column\_list'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute column list in `blocks.column_list` to the parent block; identify parent records where that nested column list object is absent.
            * **Interpretation:** Notion reports column list as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-created-by-b80c53ff5057" title="Created By" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.created_by`

            **Created By.** User who created the block. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute created by in `blocks.created_by` to the parent block; identify parent records where that nested created by object is absent.
            * **Interpretation:** Notion reports created by as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-created-time-16564b46b663" title="Created Time" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.created_time`

            **Created Time.** ISO 8601 timestamp when the block was created. It anchors the block on the provider's reported timeline.

            * **Enables:** Order Blocks by created time in `blocks.created_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports created time as a timestamp on each block; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-divider-aabb047c1645" title="Divider" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.divider`

            **Divider.** Divider block content. Present when type is 'divider'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute divider in `blocks.divider` to the parent block; identify parent records where that nested divider object is absent.
            * **Interpretation:** Notion reports divider as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-embed-418fdde26b10" title="Embed" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.embed`

            **Embed.** Embed block content. Present when type is 'embed'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute embed in `blocks.embed` to the parent block; identify parent records where that nested embed object is absent.
            * **Interpretation:** Notion reports embed as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-embed-caption-f522f7fa16f3" title="Caption" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.embed.caption`

            **Caption.** Caption for the embed. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned caption content in `blocks.EmbedBlock.caption` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns caption as ordered content or provider-generated content metadata on each embed block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-embed-url-dfb1e01a046a" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.embed.url`

            **URL.** The URL of the embedded content. It locates the provider resource or path associated with the embed block.

            * **Enables:** Associate each embed block with the resource identified by URL in `blocks.EmbedBlock.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each embed block; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-equation-205d0de03c61" title="Equation" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.equation`

            **Equation.** Equation block content. Present when type is 'equation'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute equation in `blocks.equation` to the parent block; identify parent records where that nested equation object is absent.
            * **Interpretation:** Notion reports equation as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-equation-expression-e902d14984cb" title="Expression" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.equation.expression`

            **Expression.** The LaTeX/KaTeX expression. It must be interpreted with the enclosing provider field name, type, or custom schema for the equation block.

            * **Enables:** Interpret `blocks.EquationBlock.expression` with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
            * **Interpretation:** Notion reports expression under the enclosing custom or typed field contract on each equation block; compare it only with values from the same provider key and type.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-file-0756af2d19da" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.file`

            **File.** File block content. Present when type is 'file'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute file in `blocks.file` to the parent block; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-has-children-44fe78b53ee3" title="Has Children" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.has_children`

            **Has Children.** Whether this block has nested child blocks. It distinguishes the provider-defined has children state or classification for the block.

            * **Enables:** Filter Blocks by whether this block has nested child blocks in `blocks.has_children`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports this block has nested child blocks as a boolean on each block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-1-d0b776104c97" title="Heading 1" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_1`

            **Heading 1.** Heading 1 block content. Present when type is 'heading\_1'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute heading 1 in `blocks.heading_1` to the parent block; identify parent records where that nested heading 1 object is absent.
            * **Interpretation:** Notion reports heading 1 as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-1-color-53fc57c592bc" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_1.color`

            **Color.** Color of the heading text or background. It supplies the returned color text needed to understand the heading block in context.

            * **Enables:** Search the returned color text in `blocks.HeadingBlock.color` and attribute each match to its parent block and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each heading block; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-1-is-toggleable-f411cd2a0b43" title="Is Toggleable" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_1.is_toggleable`

            **Is Toggleable.** Whether the heading can be toggled to show/hide children. It distinguishes the provider-defined is toggleable state or classification for the heading block.

            * **Enables:** Filter Blocks by whether the heading can be toggled to show/hide children in `blocks.HeadingBlock.is_toggleable`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the heading can be toggled to show/hide children as a boolean on each heading block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-1-rich-text-bd2169dd3058" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_1.rich_text`

            **Rich Text.** Array of rich text objects forming the heading content. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned rich text content in `blocks.HeadingBlock.rich_text` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each heading block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-2-f67c177063c3" title="Heading 2" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_2`

            **Heading 2.** Heading 2 block content. Present when type is 'heading\_2'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute heading 2 in `blocks.heading_2` to the parent block; identify parent records where that nested heading 2 object is absent.
            * **Interpretation:** Notion reports heading 2 as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-heading-3-73e0a056748a" title="Heading 3" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.heading_3`

            **Heading 3.** Heading 3 block content. Present when type is 'heading\_3'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute heading 3 in `blocks.heading_3` to the parent block; identify parent records where that nested heading 3 object is absent.
            * **Interpretation:** Notion reports heading 3 as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-id-3adf69da974a" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.id`

            **ID.** Unique identifier for the block (UUID). It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Match repeated block entries on ID in `blocks.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its block namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-image-096139c40c55" title="Image" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.image`

            **Image.** Image block content. Present when type is 'image'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute image in `blocks.image` to the parent block; identify parent records where that nested image object is absent.
            * **Interpretation:** Notion reports image as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-in-trash-0bf97ca1c59d" title="In Trash" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.in_trash`

            **In Trash.** Whether the block is in the trash. It distinguishes the provider-defined in trash state or classification for the block.

            * **Enables:** Filter Blocks by whether the block is in the trash in `blocks.in_trash`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the block is in the trash as a boolean on each block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-is-locked-4a08ee691316" title="Is Locked" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.is_locked`

            **Is Locked.** Whether the block is locked from edits. It distinguishes the provider-defined is locked state or classification for the block.

            * **Enables:** Filter Blocks by whether the block is locked from edits in `blocks.is_locked`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the block is locked from edits as a boolean on each block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-last-edited-by-9bb9e733d415" title="Last Edited By" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.last_edited_by`

            **Last Edited By.** User who last edited the block. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute last edited by in `blocks.last_edited_by` to the parent block; identify parent records where that nested last edited by object is absent.
            * **Interpretation:** Notion reports last edited by as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-last-edited-time-1d5e2c006f39" title="Last Edited Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.last_edited_time`

            **Last Edited Time.** ISO 8601 timestamp when the block was last modified. It anchors the block on the provider's reported timeline.

            * **Enables:** Order Blocks by last edited time in `blocks.last_edited_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports last edited time as a timestamp on each block; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-preview-e49ae3c25ea3" title="Link Preview" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_preview`

            **Link Preview.** Link preview block content. Present when type is 'link\_preview'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute link preview in `blocks.link_preview` to the parent block; identify parent records where that nested link preview object is absent.
            * **Interpretation:** Notion reports link preview as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-preview-url-66d83afe9cc0" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_preview.url`

            **URL.** The URL being previewed. It locates the provider resource or path associated with the link preview block.

            * **Enables:** Associate each link preview block with the resource identified by URL in `blocks.LinkPreviewBlock.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each link preview block; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-to-page-584ed45354ad" title="Link To Page" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_to_page`

            **Link To Page.** Link to page block content. Present when type is 'link\_to\_page'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute link to page in `blocks.link_to_page` to the parent block; identify parent records where that nested link to page object is absent.
            * **Interpretation:** Notion reports link to page as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-to-page-comment-id-35e41eab734f" title="Comment ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_to_page.comment_id`

            **Comment ID.** The ID of the linked comment. Present when type is 'comment\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each link to page block in Blocks to the referenced comment through `blocks.LinkToPageBlock.comment_id`; flag comment ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports comment ID as an identifier in its comment namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-to-page-database-id-50f5b715cf35" title="Database ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_to_page.database_id`

            **Database ID.** The ID of the linked database. Present when type is 'database\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each link to page block in Blocks to the referenced database through `blocks.LinkToPageBlock.database_id`; flag database ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports database ID as an identifier in its database namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-to-page-page-id-f5adfe7e851e" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_to_page.page_id`

            **Page ID.** The ID of the linked page. Present when type is 'page\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each link to page block in Blocks to the referenced page through `blocks.LinkToPageBlock.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-link-to-page-type-9f36e4ae311e" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.link_to_page.type`

            **Type.** The type of link ('page\_id', 'database\_id', or 'comment\_id'). It locates the provider resource or path associated with the link to page block.

            * **Enables:** Segment link to page block entries in Blocks by type in `blocks.LinkToPageBlock.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each link to page block; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-numbered-list-item-f553f5f389a5" title="Numbered List Item" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.numbered_list_item`

            **Numbered List Item.** Numbered list item content. Present when type is 'numbered\_list\_item'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute numbered list item in `blocks.numbered_list_item` to the parent block; identify parent records where that nested numbered list item object is absent.
            * **Interpretation:** Notion reports numbered list item as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-object-14e524df5ca1" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.object`

            **Object.** Always 'block' for block objects. It distinguishes the provider-defined object state or classification for the block.

            * **Enables:** Filter Blocks by the exact Notion-defined object in `blocks.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each block; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-page-id-b8f42bb97aa7" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.page_id`

            **Page ID.** Parent page reference copied into each block because the child operation does not return that relationship. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each block in Blocks to the referenced page through `blocks.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Parable copies page ID from the parent traversal record into each block; the child Notion operation does not return it.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-paragraph-ce99a54e8b7f" title="Paragraph" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.paragraph`

            **Paragraph.** Paragraph block content. Present when type is 'paragraph'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute paragraph in `blocks.paragraph` to the parent block; identify parent records where that nested paragraph object is absent.
            * **Interpretation:** Notion reports paragraph as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-4814e0d44248" title="Parent" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent`

            **Parent.** Parent object reference (page\_id, block\_id, database\_id, or workspace). It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute parent in `blocks.parent` to the parent block; identify parent records where that nested parent object is absent.
            * **Interpretation:** Notion reports parent as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-block-id-c91cd97e2ef1" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent.block_id`

            **Block ID.** The ID of the parent block. Present when type is 'block\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each block parent in Blocks to the referenced block through `blocks.BlockParent.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-database-id-30d17ef77603" title="Database ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent.database_id`

            **Database ID.** The ID of the parent database. Present when type is 'database\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each block parent in Blocks to the referenced database through `blocks.BlockParent.database_id`; flag database ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports database ID as an identifier in its database namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-page-id-5272b1596314" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent.page_id`

            **Page ID.** The ID of the parent page. Present when type is 'page\_id'. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each block parent in Blocks to the referenced page through `blocks.BlockParent.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-type-c9f75b156954" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent.type`

            **Type.** The type of parent (page\_id, block\_id, database\_id, workspace). It distinguishes the provider-defined type state or classification for the block parent.

            * **Enables:** Segment block parent entries in Blocks by type in `blocks.BlockParent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each block parent; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-parent-workspace-1fce04bde0d8" title="Workspace" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.parent.workspace`

            **Workspace.** True if the parent is the workspace. Present when type is 'workspace'. It distinguishes the provider-defined workspace state or classification for the block parent.

            * **Enables:** Filter Blocks by whether true if the parent is the workspace in `blocks.BlockParent.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports true if the parent is the workspace as a boolean on each block parent; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-pdf-365c682d5756" title="PDF" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.pdf`

            **PDF.** PDF block content. Present when type is 'pdf'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute pdf in `blocks.pdf` to the parent block; identify parent records where that nested pdf object is absent.
            * **Interpretation:** Notion reports pdf as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-public-url-5934d6953f75" title="Public URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.public_url`

            **Public URL.** Public-facing Notion URL for the block, when the block belongs to a shared page. It locates the provider resource or path associated with the block.

            * **Enables:** Associate each block with the resource identified by public URL in `blocks.public_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports public URL as a resource locator for each block; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-quote-161a70cc6bf6" title="Quote" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.quote`

            **Quote.** Quote block content. Present when type is 'quote'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute quote in `blocks.quote` to the parent block; identify parent records where that nested quote object is absent.
            * **Interpretation:** Notion reports quote as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-synced-block-5e555ce1af5d" title="Synced Block" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.synced_block`

            **Synced Block.** Synced block content. Present when type is 'synced\_block'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute synced block in `blocks.synced_block` to the parent block; identify parent records where that nested synced block object is absent.
            * **Interpretation:** Notion reports synced block as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-synced-block-synced-from-9ff5410c9a55" title="Synced From" icon="brackets-curly" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.synced_block.synced_from`

            **Synced From.** Reference to the original synced block. Null if this is the original. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute synced from in `blocks.SyncedBlock.synced_from` to the parent block; identify parent records where that nested synced from object is absent.
            * **Interpretation:** Notion reports synced from as a nested object on each synced block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-synced-block-synced-from-block-id-98e8e119aeaa" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.synced_block.synced_from.block_id`

            **Block ID.** The ID of the original synced block. It provides the reference needed to connect the block to the corresponding provider object.

            * **Enables:** Connect each synced from in Blocks to the referenced block through `blocks.SyncedFrom.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-synced-block-synced-from-type-74cb1f5e1861" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.synced_block.synced_from.type`

            **Type.** Always 'block\_id'. It distinguishes the provider-defined type state or classification for the synced from.

            * **Enables:** Segment synced from entries in Blocks by type in `blocks.SyncedFrom.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each synced from; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-f1f59d6881f9" title="Table" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table`

            **Table.** Table block content. Present when type is 'table'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute table in `blocks.table` to the parent block; identify parent records where that nested table object is absent.
            * **Interpretation:** Notion reports table as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-has-column-header-a63c5e95dcd0" title="Has Column Header" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table.has_column_header`

            **Has Column Header.** Whether the first row is a header row. It distinguishes the provider-defined has column header state or classification for the table block.

            * **Enables:** Filter Blocks by whether the first row is a header row in `blocks.TableBlock.has_column_header`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the first row is a header row as a boolean on each table block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-has-row-header-221bb85b3ec3" title="Has Row Header" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table.has_row_header`

            **Has Row Header.** Whether the first column is a header column. It distinguishes the provider-defined has row header state or classification for the table block.

            * **Enables:** Filter Blocks by whether the first column is a header column in `blocks.TableBlock.has_row_header`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the first column is a header column as a boolean on each table block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-table-width-d41a3b73329e" title="Table Width" icon="chart-pie" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table.table_width`

            **Table Width.** Number of columns in the table. It supplies the table width measure for the table block at the provider's declared unit and grain.

            * **Enables:** Measure table width through `blocks.TableBlock.table_width` for each table block and compare only values with the same unit and record grain.
            * **Interpretation:** Notion reports table width as a measure on each table block; compare only records with the same unit and aggregation grain.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-of-contents-08ed1c5d1baa" title="Table Of Contents" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table_of_contents`

            **Table Of Contents.** Table of contents block content. Present when type is 'table\_of\_contents'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute table of contents in `blocks.table_of_contents` to the parent block; identify parent records where that nested table of contents object is absent.
            * **Interpretation:** Notion reports table of contents as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-of-contents-color-d188e27d4cea" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table_of_contents.color`

            **Color.** Color of the table of contents text. It supplies the returned color text needed to understand the table of contents block in context.

            * **Enables:** Search the returned color text in `blocks.TableOfContentsBlock.color` and attribute each match to its parent block and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each table of contents block; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-row-107718a6af5b" title="Table Row" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table_row`

            **Table Row.** Table row block content. Present when type is 'table\_row'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute table row in `blocks.table_row` to the parent block; identify parent records where that nested table row object is absent.
            * **Interpretation:** Notion reports table row as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-row-cells-618b0d327765" title="Cells" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table_row.cells`

            **Cells.** Array of cell contents. Each cell is an array of rich text objects. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned cells content in `blocks.TableRowBlock.cells` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns cells as ordered content or provider-generated content metadata on each table row block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-table-row-cells-items-70956e5a732f" title="Items" icon="code-branch" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.table_row.cells.items`

            **Items.** The structured items details attached to each table row block cell in Blocks. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute items in `blocks.TableRowBlockCell.items` to the parent block; identify parent records where that nested items object is absent.
            * **Interpretation:** Notion reports items as a nested object on each table row block cell; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-template-3e253198878a" title="Template" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.template`

            **Template.** Template block content. Present when type is 'template'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute template in `blocks.template` to the parent block; identify parent records where that nested template object is absent.
            * **Interpretation:** Notion reports template as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-to-do-08b0a18e868e" title="To Do" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.to_do`

            **To Do.** To-do block content. Present when type is 'to\_do'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute to do in `blocks.to_do` to the parent block; identify parent records where that nested to do object is absent.
            * **Interpretation:** Notion reports to do as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-to-do-checked-7bebac92dd4e" title="Checked" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.to_do.checked`

            **Checked.** Whether the to-do item is checked. It distinguishes the provider-defined checked state or classification for the to do block.

            * **Enables:** Filter Blocks by whether the to-do item is checked in `blocks.ToDoBlock.checked`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the to-do item is checked as a boolean on each to do block; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-to-do-color-984c08defdf5" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.to_do.color`

            **Color.** Color of the to-do text or background. It supplies the returned color text needed to understand the to do block in context.

            * **Enables:** Search the returned color text in `blocks.ToDoBlock.color` and attribute each match to its parent block and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each to do block; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-to-do-rich-text-baec8c67a687" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.to_do.rich_text`

            **Rich Text.** Array of rich text objects forming the to-do content. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Search the returned rich text content in `blocks.ToDoBlock.rich_text` while preserving element order and attribution to the parent block.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each to do block; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-toggle-ebc9d677d209" title="Toggle" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.toggle`

            **Toggle.** Toggle block content. Present when type is 'toggle'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute toggle in `blocks.toggle` to the parent block; identify parent records where that nested toggle object is absent.
            * **Interpretation:** Notion reports toggle as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-type-257aeb8f374d" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.type`

            **Type.** The type of block (paragraph, heading\_1, to\_do, etc.). It distinguishes the provider-defined type state or classification for the block.

            * **Enables:** Segment block entries in Blocks by type in `blocks.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each block; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-url-4f8bc457d037" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.url`

            **URL.** Internal Notion URL for the block, when one is available. It locates the provider resource or path associated with the block.

            * **Enables:** Associate each block with the resource identified by URL in `blocks.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each block; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-blocks-video-d667a25f604a" title="Video" icon="video" iconType="sharp-duotone-solid">
            Developer identifier: `blocks.video`

            **Video.** Video block content. Present when type is 'video'. It preserves the nested context needed to interpret the parent block.

            * **Enables:** Attribute video in `blocks.video` to the parent block; identify parent records where that nested video object is absent.
            * **Interpretation:** Notion reports video as a nested object on each block; optional children may be absent from a valid response.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-notion-comments-b20bb9f37cde" title="Comments" icon="comments" iconType="sharp-duotone-solid">
        Developer identifier: `comments`

        **Comments.** Comments on a page or block.

        * **Enables:** Attribute visible comment text to its author, discussion, page or block, and timestamp.
        * **Scope:** Reads the records selected by Notion's `/v1/comments` operation as a snapshot stream using full synchronization. This stream is opt-in. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. Comment rich text is included, but referenced file bytes and unshared page content are not. A later complete read can treat a previously seen record that is absent as removed.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-comments-attachments-c26f0cb0fa21" title="Attachments" icon="badge-check" iconType="sharp-duotone-solid">
            Developer identifier: `comments.attachments`

            **Attachments.** Files attached to the comment (2026 Notion API). It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Associate each returned Notion comment attachment metadata entry in `comments.attachments` with the parent comment; inventory the reference without assuming file, recording, or attachment bytes are present.
            * **Interpretation:** Notion returns attachments as file, recording, or attachment metadata on each comment; the array does not imply that binary content was collected. This field is metadata or a reference for the file or attachment; it does not by itself include binary content.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-attachments-category-93868e741f12" title="Category" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `comments.attachments.category`

            **Category.** Attachment category, e.g. 'audio', 'image', 'pdf', 'video'. It identifies the file, document, recording, or attachment metadata associated with the Notion comment attachment.

            * **Enables:** Segment Notion comment attachment entries in Comments by category in `comments.NotionCommentAttachment.category`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports category as a label from its own taxonomy on each Notion comment attachment; preserve unknown labels rather than mapping them by assumption. This field is metadata or a reference for the file or attachment; it does not by itself include binary content.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-attachments-file-0127370fa865" title="File" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `comments.attachments.file`

            **File.** The attached Notion-hosted file with a temporary signed URL. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute file in `comments.NotionCommentAttachment.file` to the parent comment; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each Notion comment attachment; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-attachments-file-expiry-time-9239e97c20cb" title="Expiry Time" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.attachments.file.expiry_time`

            **Expiry Time.** ISO 8601 expiration time for the signed URL. It anchors the comment on the provider's reported timeline.

            * **Enables:** Order Comments by expiry time in `comments.NotionCommentAttachment.file.expiry_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports expiry time as a timestamp on each file; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-attachments-file-url-0f9f51fb833b" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.attachments.file.url`

            **URL.** Temporary signed URL for the attached file. It locates the provider resource or path associated with the file.

            * **Enables:** Associate each file with the resource identified by URL in `comments.NotionCommentAttachment.file.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each file; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-created-by-81a676fdd47a" title="Created By" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `comments.created_by`

            **Created By.** The user who created the comment. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute created by in `comments.created_by` to the parent comment; identify parent records where that nested created by object is absent.
            * **Interpretation:** Notion reports created by as a nested object on each comment; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-created-by-id-3b0b18045ef9" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.created_by.id`

            **ID.** UUID of the user. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each partial user in Comments to the referenced partial user through `comments.PartialUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its partial user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-created-by-object-bf713a4738cb" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `comments.created_by.object`

            **Object.** Always 'user' for user objects. It distinguishes the provider-defined object state or classification for the partial user.

            * **Enables:** Filter Comments by the exact Notion-defined object in `comments.PartialUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each partial user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-created-time-1c2c00bb32d9" title="Created Time" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `comments.created_time`

            **Created Time.** ISO 8601 timestamp of when the comment was created. It anchors the comment on the provider's reported timeline.

            * **Enables:** Order Comments by created time in `comments.created_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports created time as a timestamp on each comment; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-discussion-id-5edc86d763de" title="Discussion ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.discussion_id`

            **Discussion ID.** The discussion thread UUID this comment belongs to. Groups comments into conversation threads. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each comment in Comments to the referenced discussion through `comments.discussion_id`; flag discussion ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports discussion ID as an identifier in its discussion namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-display-name-1825ef0d2fb8" title="Display Name" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `comments.display_name`

            **Display Name.** Display name of the comment author, present for comments authored via public API integrations (2026 Notion API). It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute display name in `comments.display_name` to the parent comment; identify parent records where that nested display name object is absent.
            * **Interpretation:** Notion reports display name as a nested object on each comment; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-display-name-custom-bbe6df1787f3" title="Custom" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `comments.display_name.custom`

            **Custom.** Custom display name payload, present when type is 'custom'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute custom in `comments.display_name.custom` to the parent comment; identify parent records where that nested custom object is absent.
            * **Interpretation:** Notion reports custom as a nested object on each display name; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-display-name-resolved-name-a54d45444b0d" title="Resolved Name" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `comments.display_name.resolved_name`

            **Resolved Name.** The resolved display name text. It supplies the returned resolved name text needed to understand the display name in context.

            * **Enables:** Label each display name with resolved name from `comments.display_name.resolved_name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports resolved name as display text for each display name; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-display-name-type-6a76123be94a" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.display_name.type`

            **Type.** Source of the display name: 'user', 'integration', or 'custom'. It distinguishes the provider-defined type state or classification for the display name.

            * **Enables:** Segment display name entries in Comments by type in `comments.display_name.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each display name; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-id-2a6d6d74882b" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.id`

            **ID.** Unique identifier (UUID) for the comment. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Match repeated comment entries on ID in `comments.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its comment namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-last-edited-time-dbe3212b45f9" title="Last Edited Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `comments.last_edited_time`

            **Last Edited Time.** ISO 8601 timestamp of when the comment was last edited. It anchors the comment on the provider's reported timeline.

            * **Enables:** Order Comments by last edited time in `comments.last_edited_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports last edited time as a timestamp on each comment; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-object-af6d7c5cdb5e" title="Object" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.object`

            **Object.** Always 'comment' for comment objects. It supplies the returned object text needed to understand the comment in context.

            * **Enables:** Search the returned object text in `comments.object` and attribute each match to its parent comment and reported author when available.
            * **Interpretation:** Notion supplies object as returned text on each comment; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-page-id-a62880803246" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.page_id`

            **Page ID.** Parent page reference copied into each comment because the child operation does not return that relationship. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each comment in Comments to the referenced page through `comments.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Parable copies page ID from the parent traversal record into each comment; the child Notion operation does not return it.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-parent-e45c3bf726ad" title="Parent" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `comments.parent`

            **Parent.** Parent reference indicating which page or block the comment is attached to. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute parent in `comments.parent` to the parent comment; identify parent records where that nested parent object is absent.
            * **Interpretation:** Notion reports parent as a nested object on each comment; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-parent-block-id-7a5fc1217aa6" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `comments.parent.block_id`

            **Block ID.** The UUID of the parent block, present when type is 'block\_id'. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each comment parent in Comments to the referenced block through `comments.CommentParent.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-parent-page-id-0318da62b00b" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.parent.page_id`

            **Page ID.** The UUID of the parent page, present when type is 'page\_id'. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each comment parent in Comments to the referenced page through `comments.CommentParent.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-parent-type-e43ce0807309" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.parent.type`

            **Type.** The type of parent: 'page\_id' or 'block\_id'. It distinguishes the provider-defined type state or classification for the comment parent.

            * **Enables:** Segment comment parent entries in Comments by type in `comments.CommentParent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each comment parent; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-3e2d79dd94a3" title="Rich Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text`

            **Rich Text.** The comment content as an array of rich text objects. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Search the returned rich text content in `comments.rich_text` while preserving element order and attribution to the parent comment.
            * **Interpretation:** Notion returns rich text as ordered content or provider-generated content metadata on each comment; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-d86847da7257" title="Annotations" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations`

            **Annotations.** Style annotations applied to this rich text segment. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute annotations in `comments.RichText.annotations` to the parent comment; identify parent records where that nested annotations object is absent.
            * **Interpretation:** Notion reports annotations as a nested object on each rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-bold-9dfbc5b9e7a1" title="Bold" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.bold`

            **Bold.** Whether the text is bold. It distinguishes the provider-defined bold state or classification for the rich text annotation.

            * **Enables:** Filter Comments by whether the text is bold in `comments.RichTextAnnotations.bold`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is bold as a boolean on each rich text annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-code-17d92f508812" title="Code" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.code`

            **Code.** Whether the text is displayed as inline code. It distinguishes the provider-defined code state or classification for the rich text annotation.

            * **Enables:** Filter Comments by whether the text is displayed as inline code in `comments.RichTextAnnotations.code`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is displayed as inline code as a boolean on each rich text annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-color-e0061040af95" title="Color" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.color`

            **Color.** The color of the text or its background. It distinguishes the provider-defined color state or classification for the rich text annotation.

            * **Enables:** Segment rich text annotation entries in Comments by color in `comments.RichTextAnnotations.color`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports color as a label from its own taxonomy on each rich text annotation; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-italic-d3ed0e12c934" title="Italic" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.italic`

            **Italic.** Whether the text is italic. It distinguishes the provider-defined italic state or classification for the rich text annotation.

            * **Enables:** Filter Comments by whether the text is italic in `comments.RichTextAnnotations.italic`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is italic as a boolean on each rich text annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-strikethro-5235fafead6d" title="Strikethrough" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.strikethrough`

            **Strikethrough.** Whether the text has strikethrough. It distinguishes the provider-defined strikethrough state or classification for the rich text annotation.

            * **Enables:** Filter Comments by whether the text has strikethrough in `comments.RichTextAnnotations.strikethrough`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text has strikethrough as a boolean on each rich text annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-annotations-underline-c0ae9ee9761d" title="Underline" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.annotations.underline`

            **Underline.** Whether the text is underlined. It distinguishes the provider-defined underline state or classification for the rich text annotation.

            * **Enables:** Filter Comments by whether the text is underlined in `comments.RichTextAnnotations.underline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is underlined as a boolean on each rich text annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-equation-919dd25b6c58" title="Equation" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.equation`

            **Equation.** Equation data. Present when type is 'equation'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute equation in `comments.RichText.equation` to the parent comment; identify parent records where that nested equation object is absent.
            * **Interpretation:** Notion reports equation as a nested object on each rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-equation-expression-a49df13ded17" title="Expression" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.equation.expression`

            **Expression.** The LaTeX/KaTeX expression string. It must be interpreted with the enclosing provider field name, type, or custom schema for the rich text equation.

            * **Enables:** Interpret `comments.RichTextEquation.expression` with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
            * **Interpretation:** Notion reports expression under the enclosing custom or typed field contract on each rich text equation; compare it only with values from the same provider key and type.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-href-9d6acb6a2a09" title="Href" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.href`

            **Href.** URL of any inline link in this rich text segment, if present. It locates the provider resource or path associated with the rich text.

            * **Enables:** Associate each rich text with the resource identified by href in `comments.RichText.href`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports href as a resource locator for each rich text; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-ea90f03a5933" title="Mention" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention`

            **Mention.** Mention data. Present when type is 'mention'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute mention in `comments.RichText.mention` to the parent comment; identify parent records where that nested mention object is absent.
            * **Interpretation:** Notion reports mention as a nested object on each rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-database-c784e6b25ea9" title="Database" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.database`

            **Database.** Mentioned database. Present when type is 'database'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute database in `comments.RichTextMention.database` to the parent comment; identify parent records where that nested database object is absent.
            * **Interpretation:** Notion reports database as a nested object on each rich text mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-database-id-a0a010eb7f64" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.database.id`

            **ID.** UUID of the referenced page or database. It provides the reference needed to connect the comment to the corresponding provider object.

            * **Enables:** Connect each mention reference in Comments to the referenced mention reference through `comments.MentionReference.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its mention reference namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-date-118ddfe3a59b" title="Date" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.date`

            **Date.** Date mention. Present when type is 'date'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute date in `comments.RichTextMention.date` to the parent comment; identify parent records where that nested date object is absent.
            * **Interpretation:** Notion reports date as a nested object on each rich text mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-date-end-b7adda66f187" title="End" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.date.end`

            **End.** End date or datetime in ISO 8601 format, null for single dates. It anchors the comment on the provider's reported timeline.

            * **Enables:** Filter Comments by end in `comments.MentionDate.end`; pair that boundary with the corresponding start before measuring elapsed time.
            * **Interpretation:** Notion reports end as a timestamp on each mention date; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-date-start-bde9db9d9aa1" title="Start" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.date.start`

            **Start.** Start date or datetime in ISO 8601 format. It anchors the comment on the provider's reported timeline.

            * **Enables:** Filter Comments by start in `comments.MentionDate.start`; pair that boundary with the corresponding end before measuring elapsed time.
            * **Interpretation:** Notion reports start as a timestamp on each mention date; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-date-time-zone-52cabd721b8e" title="Time Zone" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.date.time_zone`

            **Time Zone.** IANA time zone, if applicable. It is needed to interpret companion dates and times for the mention date in the provider's intended zone.

            * **Enables:** Apply the zone in `comments.MentionDate.time_zone` when converting the comment's companion start, end, or scheduled timestamps; do not infer it from locale.
            * **Interpretation:** Notion reports time zone as a timezone identifier for each mention date; supported IANA or provider-specific names and daylight-saving behavior must be preserved.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-link-preview-050bf7eb59f2" title="Link Preview" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.link_preview`

            **Link Preview.** Link preview mention. Present when type is 'link\_preview'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute link preview in `comments.RichTextMention.link_preview` to the parent comment; identify parent records where that nested link preview object is absent.
            * **Interpretation:** Notion reports link preview as a nested object on each rich text mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-link-preview-u-70cce174c249" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.link_preview.url`

            **URL.** The URL being previewed. It locates the provider resource or path associated with the mention link preview.

            * **Enables:** Associate each mention link preview with the resource identified by URL in `comments.MentionLinkPreview.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each mention link preview; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-page-faaace3d9778" title="Page" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.page`

            **Page.** Mentioned page. Present when type is 'page'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute page in `comments.RichTextMention.page` to the parent comment; identify parent records where that nested page object is absent.
            * **Interpretation:** Notion reports page as a nested object on each rich text mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-type-95a2be20a357" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.type`

            **Type.** The type of mention. It distinguishes the provider-defined type state or classification for the rich text mention.

            * **Enables:** Segment rich text mention entries in Comments by type in `comments.RichTextMention.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each rich text mention; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-mention-user-459c00cde13b" title="User" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.mention.user`

            **User.** Mentioned user. Present when type is 'user'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute user in `comments.RichTextMention.user` to the parent comment; identify parent records where that nested user object is absent.
            * **Interpretation:** Notion reports user as a nested object on each rich text mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-plain-text-ccc2e31c42a5" title="Plain Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.plain_text`

            **Plain Text.** Plain text representation of this rich text segment without formatting. It defines the content surface available for this comment.

            * **Enables:** Locate rich text records by plain text in `comments.RichText.plain_text`; attribute each text match to its parent comment and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-text-bfa15066bc07" title="Text" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.text`

            **Text.** Text content and optional link. Present when type is 'text'. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute text in `comments.RichText.text` to the parent comment; identify parent records where that nested text object is absent.
            * **Interpretation:** Notion reports text as a nested object on each rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-text-content-65ac67d42b06" title="Content" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.text.content`

            **Content.** The actual text content. It defines the content surface available for this comment.

            * **Enables:** Locate rich text text records by content in `comments.RichTextText.content`; attribute each text match to its parent comment and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-text-link-4a2a7d82f41b" title="Link" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.text.link`

            **Link.** Optional inline link object. It preserves the nested context needed to interpret the parent comment.

            * **Enables:** Attribute link in `comments.RichTextText.link` to the parent comment; identify parent records where that nested link object is absent.
            * **Interpretation:** Notion reports link as a nested object on each rich text text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-text-link-url-6453036546fd" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.text.link.url`

            **URL.** The URL the text links to. It locates the provider resource or path associated with the rich text link.

            * **Enables:** Associate each rich text link with the resource identified by URL in `comments.RichTextLink.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each rich text link; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-comments-rich-text-type-39ab04f41470" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `comments.rich_text.type`

            **Type.** The type of rich text: text, mention, or equation. It distinguishes the provider-defined type state or classification for the rich text.

            * **Enables:** Segment rich text entries in Comments by type in `comments.RichText.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each rich text; preserve unknown labels rather than mapping them by assumption.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-notion-database-items-d6172e7dc762" title="Database Items" icon="route" iconType="sharp-duotone-solid">
        Developer identifier: `database_items`

        **Database Items.** Items (pages) within a data source.

        * **Enables:** Match each data-source page to its parent data source and compare provider-defined property values and lifecycle timestamps.
        * **Scope:** Reads the records selected by Notion's `/v1/data_sources/{id}/query` operation as a snapshot stream using incremental synchronization. This stream is opt-in. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. Removal is recognized from the provider's tombstone state rather than absence alone.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-database-items-archived-655d9a48bc9f" title="Archived" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.archived`

            **Archived.** Whether the item is archived (completed or removed). It distinguishes the provider-defined archived state or classification for the database item.

            * **Enables:** Filter Database Items by whether the item is archived (completed or removed) in `database_items.archived`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the item is archived (completed or removed) as a boolean on each database item; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-a538f412496f" title="Cover" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover`

            **Cover.** Cover image for the page, or null if none. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute cover in `database_items.cover` to the parent database item; identify parent records where that nested cover object is absent.
            * **Interpretation:** Notion reports cover as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-external-3092830818cf" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.external`

            **External.** External file details, present when type is 'external'. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute external in `database_items.FileObject.external` to the parent database item; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each file object; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-external-url-fa5c3d5174c1" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.external.url`

            **URL.** URL of the external file. It locates the provider resource or path associated with the external file.

            * **Enables:** Associate each external file with the resource identified by URL in `database_items.ExternalFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each external file; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-file-fe13164edbe1" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.file`

            **File.** Notion-hosted file details, present when type is 'file'. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute file in `database_items.FileObject.file` to the parent database item; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each file object; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-file-expiry-time-b540b4395262" title="Expiry Time" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.file.expiry_time`

            **Expiry Time.** ISO 8601 expiration time for the signed URL. It anchors the database item on the provider's reported timeline.

            * **Enables:** Order Database Items by expiry time in `database_items.NotionHostedFile.expiry_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports expiry time as a timestamp on each Notion hosted file; timezone and precision follow this API field, and absence is not an inferred event time. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-file-url-2a873b82ce1d" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.file.url`

            **URL.** Temporary signed URL for the Notion-hosted file. It locates the provider resource or path associated with the Notion hosted file.

            * **Enables:** Associate each Notion hosted file with the resource identified by URL in `database_items.NotionHostedFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion hosted file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-cover-type-040fb2a8c500" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.cover.type`

            **Type.** The type of file: 'external' or 'file' (Notion-hosted). It distinguishes the provider-defined type state or classification for the file object.

            * **Enables:** Segment file object entries in Database Items by type in `database_items.FileObject.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each file object; preserve unknown labels rather than mapping them by assumption. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-created-by-367097c83972" title="Created By" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.created_by`

            **Created By.** User who created the item. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute created by in `database_items.created_by` to the parent database item; identify parent records where that nested created by object is absent.
            * **Interpretation:** Notion reports created by as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-created-by-id-3dcbd25c440c" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.created_by.id`

            **ID.** UUID of the user. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each partial user in Database Items to the referenced partial user through `database_items.PartialUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its partial user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-created-by-object-951be6f2ac9b" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.created_by.object`

            **Object.** Always 'user' for user objects. It distinguishes the provider-defined object state or classification for the partial user.

            * **Enables:** Filter Database Items by the exact Notion-defined object in `database_items.PartialUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each partial user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-created-time-3b14af8090fe" title="Created Time" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.created_time`

            **Created Time.** ISO 8601 timestamp when the item was created. It anchors the database item on the provider's reported timeline.

            * **Enables:** Order Database Items by created time in `database_items.created_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports created time as a timestamp on each database item; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-data-source-id-0032d81cb132" title="Data Source ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.data_source_id`

            **Data Source ID.** Parent data source reference copied into each database item because the child operation does not return that relationship. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each database item in Database Items to the referenced data source through `database_items.data_source_id`; flag data source ID values that do not resolve in that provider namespace.
            * **Interpretation:** Parable copies data source ID from the parent traversal record into each database item; the child Notion operation does not return it.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-icon-a21352f1399e" title="Icon" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.icon`

            **Icon.** Icon for the page (emoji or file), or null if none. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute icon in `database_items.icon` to the parent database item; identify parent records where that nested icon object is absent.
            * **Interpretation:** Notion reports icon as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-icon-emoji-036f27b9228f" title="Emoji" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.icon.emoji`

            **Emoji.** Emoji character, present when type is 'emoji'. It distinguishes the provider-defined emoji state or classification for the icon object.

            * **Enables:** Filter Database Items by the exact Notion-defined emoji in `database_items.IconObject.emoji` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies emoji from its own taxonomy on each icon object; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-icon-external-570579e8cdf2" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.icon.external`

            **External.** External file details, present when type is 'external'. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute external in `database_items.IconObject.external` to the parent database item; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each icon object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-icon-file-e346acf3ceb6" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.icon.file`

            **File.** Notion-hosted file details, present when type is 'file'. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute file in `database_items.IconObject.file` to the parent database item; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each icon object; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-icon-type-2f550cb3b6d2" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.icon.type`

            **Type.** The type of icon: 'emoji', 'external', or 'file'. It distinguishes the provider-defined type state or classification for the icon object.

            * **Enables:** Segment icon object entries in Database Items by type in `database_items.IconObject.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each icon object; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-id-22f4b1847d33" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.id`

            **ID.** Unique identifier for the database item (page). It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Match repeated database item entries on ID in `database_items.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its database item namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-in-trash-727f746cad71" title="In Trash" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.in_trash`

            **In Trash.** Whether the item is in the trash. It distinguishes the provider-defined in trash state or classification for the database item.

            * **Enables:** Filter Database Items by whether the item is in the trash in `database_items.in_trash`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the item is in the trash as a boolean on each database item; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-last-edited-by-d0ce3cd751a3" title="Last Edited By" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.last_edited_by`

            **Last Edited By.** User who last edited the item. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute last edited by in `database_items.last_edited_by` to the parent database item; identify parent records where that nested last edited by object is absent.
            * **Interpretation:** Notion reports last edited by as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-last-edited-time-835ae9f5b948" title="Last Edited Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.last_edited_time`

            **Last Edited Time.** ISO 8601 timestamp when the item was last modified. Used as incremental sync cursor. It anchors the database item on the provider's reported timeline.

            * **Enables:** Order Database Items by last edited time in `database_items.last_edited_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports last edited time as a timestamp on each database item; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-object-c60aa089e155" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.object`

            **Object.** Always 'page' for database items. It distinguishes the provider-defined object state or classification for the database item.

            * **Enables:** Filter Database Items by the exact Notion-defined object in `database_items.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each database item; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-e054227f25f0" title="Parent" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent`

            **Parent.** Parent reference linking items back to their data source or database container. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute parent in `database_items.parent` to the parent database item; identify parent records where that nested parent object is absent.
            * **Interpretation:** Notion reports parent as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-block-id-6ee0d783db71" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.block_id`

            **Block ID.** UUID of the parent block, present when type is 'block\_id'. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each parent in Database Items to the referenced block through `database_items.Parent.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-data-source-id-b378254ccc3f" title="Data Source ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.data_source_id`

            **Data Source ID.** UUID of the parent data source, present when type is 'data\_source\_id' (2026 Notion API). It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each parent in Database Items to the referenced data source through `database_items.Parent.data_source_id`; flag data source ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports data source ID as an identifier in its data source namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-database-id-ac07364ca8f4" title="Database ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.database_id`

            **Database ID.** UUID of the parent database, present when type is 'database\_id'. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each parent in Database Items to the referenced database through `database_items.Parent.database_id`; flag database ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports database ID as an identifier in its database namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-page-id-8bb5a968563d" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.page_id`

            **Page ID.** UUID of the parent page, present when type is 'page\_id'. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each parent in Database Items to the referenced page through `database_items.Parent.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-type-0407a92aab34" title="Type" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.type`

            **Type.** The type of parent: database\_id, page\_id, workspace, or block\_id. It distinguishes the provider-defined type state or classification for the parent.

            * **Enables:** Segment parent entries in Database Items by type in `database_items.Parent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each parent; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-parent-workspace-364d312e4450" title="Workspace" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.parent.workspace`

            **Workspace.** True when the parent is the workspace (type is 'workspace'). It distinguishes the provider-defined workspace state or classification for the parent.

            * **Enables:** Filter Database Items by whether true when the parent is the workspace (type is 'workspace') in `database_items.Parent.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports true when the parent is the workspace (type is 'workspace') as a boolean on each parent; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-properties-c4a1ed420b9b" title="Properties" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.properties`

            **Properties.** All property values for this item. Keys are property names, values are property value objects. Structure is dynamic based on database schema and includes types like title, rich\_text, number, select, multi\_select, status, date, people, checkbox, URL, email, phone\_number, formula, relation, rollup, created\_time, created\_by, last\_edited\_time, last\_edited\_by, unique\_id, verification, and files. It preserves the nested context needed to interpret the parent database item.

            * **Enables:** Attribute properties in `database_items.properties` to the parent database item; identify parent records where that nested properties object is absent.
            * **Interpretation:** Notion reports properties as a nested object on each database item; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-public-url-8b5370ad06a5" title="Public URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.public_url`

            **Public URL.** Public URL if the page is published to the web, or null. It locates the provider resource or path associated with the database item.

            * **Enables:** Associate each database item with the resource identified by public URL in `database_items.public_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports public URL as a resource locator for each database item; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-request-id-943ae9a7c64b" title="Request ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.request_id`

            **Request ID.** Unique ID for the API request that returned this object. It provides the reference needed to connect the database item to the corresponding provider object.

            * **Enables:** Connect each database item in Database Items to the referenced request through `database_items.request_id`; flag request ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports request ID as an identifier in its request namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-database-items-url-36e01cf6338e" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `database_items.url`

            **URL.** URL to the item in Notion for deep linking. It locates the provider resource or path associated with the database item.

            * **Enables:** Associate each database item with the resource identified by URL in `database_items.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each database item; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-notion-databases-a31c98d909be" title="Databases" icon="sitemap" iconType="sharp-duotone-solid">
        Developer identifier: `databases`

        **Databases.** Databases in the workspace.

        * **Enables:** Inventory databases returned by search and connect each one to its parent, title, properties, owners, and data-source references.
        * **Scope:** Reads the records selected by Notion's `/v1/search` operation as a snapshot stream using incremental synchronization. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. Removal is recognized from the provider's tombstone state rather than absence alone.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-databases-archived-969fef265b3b" title="Archived" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `databases.archived`

            **Archived.** Whether the database is archived (soft-deleted). It distinguishes the provider-defined archived state or classification for the database.

            * **Enables:** Filter Databases by whether the database is archived (soft-deleted) in `databases.archived`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the database is archived (soft-deleted) as a boolean on each database; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-4478b293415c" title="Cover" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover`

            **Cover.** Cover image of the database, if set. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute cover in `databases.cover` to the parent database; identify parent records where that nested cover object is absent.
            * **Interpretation:** Notion reports cover as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-external-e53c2aa3a5b8" title="External" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.external`

            **External.** The structured external details attached to each Notion file in Databases. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute external in `databases.NotionFile.external` to the parent database; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each Notion file; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-external-url-484559331f1f" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.external.url`

            **URL.** The provider-reported URL for each Notion external file in Databases. It locates the provider resource or path associated with the Notion external file.

            * **Enables:** Associate each Notion external file with the resource identified by URL in `databases.NotionExternalFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion external file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-file-7956261d7760" title="File" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.file`

            **File.** The structured file details attached to each Notion file in Databases. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute file in `databases.NotionFile.file` to the parent database; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each Notion file; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-file-expiry-time-2af116cedcdb" title="Expiry Time" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.file.expiry_time`

            **Expiry Time.** The provider-reported expiry time for each Notion hosted file in Databases. It anchors the database on the provider's reported timeline.

            * **Enables:** Order Databases by expiry time in `databases.NotionHostedFile.expiry_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports expiry time as a timestamp on each Notion hosted file; timezone and precision follow this API field, and absence is not an inferred event time. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-file-url-8a44d09b3e98" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.file.url`

            **URL.** The provider-reported URL for each Notion hosted file in Databases. It locates the provider resource or path associated with the Notion hosted file.

            * **Enables:** Associate each Notion hosted file with the resource identified by URL in `databases.NotionHostedFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion hosted file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-cover-type-2fc8fb0cc77a" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `databases.cover.type`

            **Type.** The provider-reported type for each Notion file in Databases. It distinguishes the provider-defined type state or classification for the Notion file.

            * **Enables:** Segment Notion file entries in Databases by type in `databases.NotionFile.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion file; preserve unknown labels rather than mapping them by assumption. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-created-by-c50a69d51e46" title="Created By" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `databases.created_by`

            **Created By.** User who created the database. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute created by in `databases.created_by` to the parent database; identify parent records where that nested created by object is absent.
            * **Interpretation:** Notion reports created by as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-created-by-id-0690b2eb7a86" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `databases.created_by.id`

            **ID.** User ID (UUID). It provides the reference needed to connect the database to the corresponding provider object.

            * **Enables:** Connect each Notion partial user in Databases to the referenced Notion partial user through `databases.NotionPartialUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its Notion partial user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-created-by-object-12e8e1002c2a" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `databases.created_by.object`

            **Object.** Always 'user'. It distinguishes the provider-defined object state or classification for the Notion partial user.

            * **Enables:** Filter Databases by the exact Notion-defined object in `databases.NotionPartialUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each Notion partial user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-created-time-e8926811a4a6" title="Created Time" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `databases.created_time`

            **Created Time.** ISO 8601 timestamp when the database was created. It anchors the database on the provider's reported timeline.

            * **Enables:** Order Databases by created time in `databases.created_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports created time as a timestamp on each database; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-data-sources-1091179bf0a7" title="Data Sources" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `databases.data_sources`

            **Data Sources.** Array of data source references associated with this database (API version 2025-09-03+). It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute every returned Notion data source reference in `databases.data_sources` to its parent database; keep each relationship distinct and distinguish an absent array from an explicitly empty one.
            * **Interpretation:** Notion returns data sources as an array of Notion data source reference entries on each database; missing, empty, and permission-redacted arrays are not equivalent.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-data-sources-data-source-id-b12f840cbfe0" title="Data Source ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `databases.data_sources.data_source_id`

            **Data Source ID.** The provider-reported data source ID for each Notion data source reference in Databases. It provides the reference needed to connect the database to the corresponding provider object.

            * **Enables:** Match repeated Notion data source reference entries on data source ID in `databases.NotionDataSourceReference.data_source_id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports data source ID as an identifier in its data source namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-data-sources-type-4800f956b156" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `databases.data_sources.type`

            **Type.** The provider-reported type for each Notion data source reference in Databases. It identifies the related provider object that gives the Notion data source reference its parent, owner, or container context.

            * **Enables:** Segment Notion data source reference entries in Databases by type in `databases.NotionDataSourceReference.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion data source reference; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-database-parent-df105702bc8f" title="Database Parent" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `databases.database_parent`

            **Database Parent.** Grandparent of the data source (the database container's parent), present on data source search results under API 2025-09-03+. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute database parent in `databases.database_parent` to the parent database; identify parent records where that nested database parent object is absent.
            * **Interpretation:** Notion reports database parent as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-database-parent-block-id-cc87d69d782f" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `databases.database_parent.block_id`

            **Block ID.** The provider-reported block ID for each Notion parent in Databases. It provides the reference needed to connect the database to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Databases to the referenced block through `databases.NotionParent.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-database-parent-page-id-1059db71444d" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `databases.database_parent.page_id`

            **Page ID.** The provider-reported page ID for each Notion parent in Databases. It provides the reference needed to connect the database to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Databases to the referenced page through `databases.NotionParent.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-database-parent-type-327b6fc6dc5c" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `databases.database_parent.type`

            **Type.** Type of parent. It identifies the related provider object that gives the Notion parent its parent, owner, or container context.

            * **Enables:** Segment Notion parent entries in Databases by type in `databases.NotionParent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion parent; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-database-parent-workspace-0e702974e239" title="Workspace" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `databases.database_parent.workspace`

            **Workspace.** The provider-reported workspace for each Notion parent in Databases. It distinguishes the provider-defined workspace state or classification for the Notion parent.

            * **Enables:** Filter Databases by whether workspace in `databases.NotionParent.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports workspace as a boolean on each Notion parent; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-de7267798c0f" title="Description" icon="badge-check" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description`

            **Description.** Description of the database as an array of rich text objects. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Search the returned description content in `databases.description` while preserving element order and attribution to the parent database.
            * **Interpretation:** Notion returns description as ordered content or provider-generated content metadata on each database; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-d70bcffa4e66" title="Annotations" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations`

            **Annotations.** Styling annotations. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute annotations in `databases.NotionRichText.annotations` to the parent database; identify parent records where that nested annotations object is absent.
            * **Interpretation:** Notion reports annotations as a nested object on each Notion rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-bold-35a35c195c2d" title="Bold" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.bold`

            **Bold.** The provider-reported bold for each Notion annotations in Databases. It distinguishes the provider-defined bold state or classification for the Notion annotation.

            * **Enables:** Filter Databases by whether bold in `databases.NotionAnnotations.bold`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports bold as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-code-7bb64f27c29e" title="Code" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.code`

            **Code.** The provider-reported code for each Notion annotations in Databases. It distinguishes the provider-defined code state or classification for the Notion annotation.

            * **Enables:** Filter Databases by whether code in `databases.NotionAnnotations.code`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports code as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-color-1b4c92c1fe6f" title="Color" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.color`

            **Color.** The provider-reported color for each Notion annotations in Databases. It distinguishes the provider-defined color state or classification for the Notion annotation.

            * **Enables:** Filter Databases by the exact Notion-defined color in `databases.NotionAnnotations.color` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies color from its own taxonomy on each Notion annotation; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-italic-40decbc8b754" title="Italic" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.italic`

            **Italic.** The provider-reported italic for each Notion annotations in Databases. It distinguishes the provider-defined italic state or classification for the Notion annotation.

            * **Enables:** Filter Databases by whether italic in `databases.NotionAnnotations.italic`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports italic as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-striket-88b4f7c00ae9" title="Strikethrough" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.strikethrough`

            **Strikethrough.** The provider-reported strikethrough for each Notion annotations in Databases. It distinguishes the provider-defined strikethrough state or classification for the Notion annotation.

            * **Enables:** Filter Databases by whether strikethrough in `databases.NotionAnnotations.strikethrough`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports strikethrough as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-annotations-underli-104af2f6c880" title="Underline" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.annotations.underline`

            **Underline.** The provider-reported underline for each Notion annotations in Databases. It distinguishes the provider-defined underline state or classification for the Notion annotation.

            * **Enables:** Filter Databases by whether underline in `databases.NotionAnnotations.underline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports underline as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-href-d3cc41586b42" title="Href" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.href`

            **Href.** URL of any link. It locates the provider resource or path associated with the Notion rich text.

            * **Enables:** Associate each Notion rich text with the resource identified by href in `databases.NotionRichText.href`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports href as a resource locator for each Notion rich text; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-plain-text-4bc8b83537ee" title="Plain Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.plain_text`

            **Plain Text.** Plain text content without annotations. It defines the content surface available for this database.

            * **Enables:** Locate Notion rich text records by plain text in `databases.NotionRichText.plain_text`; attribute each text match to its parent database and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-description-type-078184bab8f7" title="Type" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `databases.description.type`

            **Type.** Type of rich text: 'text', 'mention', 'equation'. It supplies the returned type text needed to understand the Notion rich text in context.

            * **Enables:** Segment Notion rich text entries in Databases by type in `databases.NotionRichText.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion rich text; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-icon-c60e476e40ba" title="Icon" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `databases.icon`

            **Icon.** Icon of the database (emoji or file). It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute icon in `databases.icon` to the parent database; identify parent records where that nested icon object is absent.
            * **Interpretation:** Notion reports icon as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-icon-emoji-41bf6e4fcf64" title="Emoji" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `databases.icon.emoji`

            **Emoji.** The provider-reported emoji for each Notion icon in Databases. It distinguishes the provider-defined emoji state or classification for the Notion icon.

            * **Enables:** Filter Databases by the exact Notion-defined emoji in `databases.NotionIcon.emoji` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies emoji from its own taxonomy on each Notion icon; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-icon-external-d684297bea14" title="External" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.icon.external`

            **External.** The structured external details attached to each Notion icon in Databases. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute external in `databases.NotionIcon.external` to the parent database; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each Notion icon; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-icon-file-ac8d71c6ef88" title="File" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.icon.file`

            **File.** The structured file details attached to each Notion icon in Databases. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute file in `databases.NotionIcon.file` to the parent database; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each Notion icon; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-icon-type-ef07be09641b" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `databases.icon.type`

            **Type.** The provider-reported type for each Notion icon in Databases. It distinguishes the provider-defined type state or classification for the Notion icon.

            * **Enables:** Segment Notion icon entries in Databases by type in `databases.NotionIcon.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion icon; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-id-142e5b04b867" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `databases.id`

            **ID.** Unique identifier for the data source (UUID format with hyphens). It provides the reference needed to connect the database to the corresponding provider object.

            * **Enables:** Match repeated database entries on ID in `databases.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its database namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-in-trash-62a8205fdf99" title="In Trash" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `databases.in_trash`

            **In Trash.** Whether the database is in the trash. It distinguishes the provider-defined in trash state or classification for the database.

            * **Enables:** Filter Databases by whether the database is in the trash in `databases.in_trash`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the database is in the trash as a boolean on each database; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-is-inline-2b21b3577dbe" title="Is Inline" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `databases.is_inline`

            **Is Inline.** Whether the database is an inline database. It distinguishes the provider-defined is inline state or classification for the database.

            * **Enables:** Filter Databases by whether the database is an inline database in `databases.is_inline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the database is an inline database as a boolean on each database; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-last-edited-by-bc9d2632d148" title="Last Edited By" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `databases.last_edited_by`

            **Last Edited By.** User who last edited the database. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute last edited by in `databases.last_edited_by` to the parent database; identify parent records where that nested last edited by object is absent.
            * **Interpretation:** Notion reports last edited by as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-last-edited-time-bfdfc15f65ab" title="Last Edited Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `databases.last_edited_time`

            **Last Edited Time.** ISO 8601 timestamp when the database was last edited. It anchors the database on the provider's reported timeline.

            * **Enables:** Order Databases by last edited time in `databases.last_edited_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports last edited time as a timestamp on each database; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-object-cc9812b6d955" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `databases.object`

            **Object.** Always 'data\_source' for data source objects returned by search under Notion-Version 2025-09-03+. It distinguishes the provider-defined object state or classification for the database.

            * **Enables:** Filter Databases by the exact Notion-defined object in `databases.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each database; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-parent-b0fd51d9c520" title="Parent" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `databases.parent`

            **Parent.** Immediate parent reference; for data sources this identifies the containing database\_id. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute parent in `databases.parent` to the parent database; identify parent records where that nested parent object is absent.
            * **Interpretation:** Notion reports parent as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-properties-8806398bd62d" title="Properties" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `databases.properties`

            **Properties.** Schema definition of database properties (columns) is a NotionDatabaseProperty. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Attribute properties in `databases.properties` to the parent database; identify parent records where that nested properties object is absent.
            * **Interpretation:** Notion reports properties as a nested object on each database; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-public-url-560912a162df" title="Public URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `databases.public_url`

            **Public URL.** Public URL if the database is published to the web. It locates the provider resource or path associated with the database.

            * **Enables:** Associate each database with the resource identified by public URL in `databases.public_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports public URL as a resource locator for each database; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-title-7622ed92f4e7" title="Title" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `databases.title`

            **Title.** Title of the database as an array of rich text objects. It preserves the nested context needed to interpret the parent database.

            * **Enables:** Search the returned title content in `databases.title` while preserving element order and attribution to the parent database.
            * **Interpretation:** Notion returns title as ordered content or provider-generated content metadata on each database; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-databases-url-da9132dfc1c1" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `databases.url`

            **URL.** URL to the database in the Notion UI. It locates the provider resource or path associated with the database.

            * **Enables:** Associate each database with the resource identified by URL in `databases.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each database; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-notion-pages-7c8c175eccd4" title="Pages" icon="route" iconType="sharp-duotone-solid">
        Developer identifier: `pages`

        **Pages.** Pages in the workspace.

        * **Enables:** Inventory page metadata and properties, then connect each page to its parent and content-block traversal.
        * **Scope:** Reads the records selected by Notion's `/v1/search` operation as a snapshot stream using incremental synchronization. This stream is opt-in. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. Page records contain metadata and properties; ordered page body content is represented by the separate block stream, and file bytes are not downloaded. Removal is recognized from the provider's tombstone state rather than absence alone.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-pages-archived-539ba343bed2" title="Archived" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `pages.archived`

            **Archived.** Whether the object has been archived (soft-deleted). It distinguishes the provider-defined archived state or classification for the page.

            * **Enables:** Filter Pages by whether the object has been archived (soft-deleted) in `pages.archived`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the object has been archived (soft-deleted) as a boolean on each page; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-d77e76da8a58" title="Cover" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover`

            **Cover.** Cover image for the page or database, or null if none. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute cover in `pages.cover` to the parent page; identify parent records where that nested cover object is absent.
            * **Interpretation:** Notion reports cover as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-external-662be491c9fc" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.external`

            **External.** External file details, present when type is 'external'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute external in `pages.NotionFile.external` to the parent page; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each Notion file; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-external-url-3b1bedefa3bc" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.external.url`

            **URL.** URL of the external file. It locates the provider resource or path associated with the Notion external file.

            * **Enables:** Associate each Notion external file with the resource identified by URL in `pages.NotionExternalFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion external file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-file-dc40c6042275" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.file`

            **File.** Notion-hosted file details, present when type is 'file'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute file in `pages.NotionFile.file` to the parent page; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each Notion file; optional children may be absent from a valid response. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-file-expiry-time-23a2f7439c2a" title="Expiry Time" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.file.expiry_time`

            **Expiry Time.** ISO 8601 expiration time for the signed URL. It anchors the page on the provider's reported timeline.

            * **Enables:** Order Pages by expiry time in `pages.NotionHostedFile.expiry_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports expiry time as a timestamp on each Notion hosted file; timezone and precision follow this API field, and absence is not an inferred event time. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-file-url-db657283cc0b" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.file.url`

            **URL.** Temporary signed URL for the Notion-hosted file. It locates the provider resource or path associated with the Notion hosted file.

            * **Enables:** Associate each Notion hosted file with the resource identified by URL in `pages.NotionHostedFile.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion hosted file; access still depends on viewer permissions and the URL may expire or change. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-cover-type-bb4f5183246a" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.cover.type`

            **Type.** File hosting type: 'external' or 'file'. It distinguishes the provider-defined type state or classification for the Notion file.

            * **Enables:** Segment Notion file entries in Pages by type in `pages.NotionFile.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion file; preserve unknown labels rather than mapping them by assumption. This stream treats the file or attachment as metadata and references; binary bytes are not included.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-cf8fc5a24d10" title="Created By" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by`

            **Created By.** Partial user object representing who created this object. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute created by in `pages.created_by` to the parent page; identify parent records where that nested created by object is absent.
            * **Interpretation:** Notion reports created by as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-avatar-url-8797cf80597b" title="Avatar URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.avatar_url`

            **Avatar URL.** URL of the user's avatar image. It locates the provider resource or path associated with the Notion partial user.

            * **Enables:** Associate each Notion partial user with the resource identified by avatar URL in `pages.NotionPartialUser.avatar_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports avatar URL as a resource locator for each Notion partial user; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-79943f22a8e7" title="Bot" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot`

            **Bot.** Bot-specific details, present when type is 'bot'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute bot in `pages.NotionPartialUser.bot` to the parent page; identify parent records where that nested bot object is absent.
            * **Interpretation:** Notion reports bot as a nested object on each Notion partial user; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-owner-bc29645504e5" title="Owner" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot.owner`

            **Owner.** Owner of the bot integration. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute owner in `pages.NotionBotDetail.owner` to the parent page; identify parent records where that nested owner object is absent.
            * **Interpretation:** Notion reports owner as a nested object on each Notion bot detail; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-owner-type-bcafffca8d4b" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot.owner.type`

            **Type.** Owner type: 'workspace' or 'user'. It distinguishes the provider-defined type state or classification for the Notion bot owner.

            * **Enables:** Segment Notion bot owner entries in Pages by type in `pages.NotionBotOwner.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion bot owner; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-owner-user-b5353b7ac2f3" title="User" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot.owner.user`

            **User.** User owner if the bot is user-level. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute user in `pages.NotionBotOwner.user` to the parent page; identify parent records where that nested user object is absent.
            * **Interpretation:** Notion reports user as a nested object on each Notion bot owner; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-owner-workspace-a52769d13fbf" title="Workspace" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot.owner.workspace`

            **Workspace.** True if the bot is workspace-level. It distinguishes the provider-defined workspace state or classification for the Notion bot owner.

            * **Enables:** Filter Pages by whether true if the bot is workspace-level in `pages.NotionBotOwner.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports true if the bot is workspace-level as a boolean on each Notion bot owner; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-bot-workspace-name-6681bcbbc2a4" title="Workspace Name" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.bot.workspace_name`

            **Workspace Name.** Name of the workspace the bot belongs to. It gives the Notion bot detail a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each Notion bot detail with workspace name from `pages.NotionBotDetail.workspace_name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports workspace name as display text for each Notion bot detail; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-id-a55ceadef81f" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.id`

            **ID.** UUID of the user. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion partial user in Pages to the referenced Notion partial user through `pages.NotionPartialUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its Notion partial user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-name-0682531b144b" title="Name" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.name`

            **Name.** Display name of the user (may not be present in partial references). It gives the Notion partial user a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each Notion partial user with name from `pages.NotionPartialUser.name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports name as display text for each Notion partial user; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-object-0493f940dd24" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.object`

            **Object.** Always 'user'. It distinguishes the provider-defined object state or classification for the Notion partial user.

            * **Enables:** Filter Pages by the exact Notion-defined object in `pages.NotionPartialUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each Notion partial user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-person-9a62e4c4a858" title="Person" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.person`

            **Person.** Person-specific details, present when type is 'person'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute person in `pages.NotionPartialUser.person` to the parent page; identify parent records where that nested person object is absent.
            * **Interpretation:** Notion reports person as a nested object on each Notion partial user; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-person-email-b1b4ccf9f088" title="Email" icon="inbox" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.person.email`

            **Email.** Email address of the person. It supplies the provider-reported address or location facet for the Notion person detail, not a residency determination.

            * **Enables:** Attribute each Notion person detail to a person or account by the exact email in `pages.NotionPersonDetail.email`; identify addresses that do not match the Notion directory.
            * **Interpretation:** Notion reports email as an address on each Notion person detail; aliases, casing, and unverified addresses can prevent a one-to-one person match.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-by-type-4e343f9b5feb" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_by.type`

            **Type.** Type of user: 'person' or 'bot'. It distinguishes the provider-defined type state or classification for the Notion partial user.

            * **Enables:** Segment Notion partial user entries in Pages by type in `pages.NotionPartialUser.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion partial user; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-created-time-66753b015c2d" title="Created Time" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `pages.created_time`

            **Created Time.** ISO 8601 timestamp when the object was created. It anchors the page on the provider's reported timeline.

            * **Enables:** Order Pages by created time in `pages.created_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports created time as a timestamp on each page; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-cac6085d4be9" title="Description" icon="badge-check" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description`

            **Description.** Description rich text array (present on database objects). It preserves the nested context needed to interpret the parent page.

            * **Enables:** Search the returned description content in `pages.description` while preserving element order and attribution to the parent page.
            * **Interpretation:** Notion returns description as ordered content or provider-generated content metadata on each page; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-444ae47966b0" title="Annotations" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations`

            **Annotations.** Styling annotations applied to this text segment. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute annotations in `pages.NotionRichText.annotations` to the parent page; identify parent records where that nested annotations object is absent.
            * **Interpretation:** Notion reports annotations as a nested object on each Notion rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-bold-8f3fde60381f" title="Bold" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.bold`

            **Bold.** Whether the text is bold. It distinguishes the provider-defined bold state or classification for the Notion annotation.

            * **Enables:** Filter Pages by whether the text is bold in `pages.NotionAnnotations.bold`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is bold as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-code-0b39b046e204" title="Code" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.code`

            **Code.** Whether the text is displayed as inline code. It distinguishes the provider-defined code state or classification for the Notion annotation.

            * **Enables:** Filter Pages by whether the text is displayed as inline code in `pages.NotionAnnotations.code`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is displayed as inline code as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-color-8edc33ad9567" title="Color" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.color`

            **Color.** Text color or background color name (e.g., 'default', 'red', 'blue\_background'). It supplies the returned color text needed to understand the Notion annotation in context.

            * **Enables:** Search the returned color text in `pages.NotionAnnotations.color` and attribute each match to its parent page and reported author when available.
            * **Interpretation:** Notion supplies color as returned text on each Notion annotation; truncation, formatting, and access boundaries can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-italic-b1117b49ccd3" title="Italic" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.italic`

            **Italic.** Whether the text is italic. It distinguishes the provider-defined italic state or classification for the Notion annotation.

            * **Enables:** Filter Pages by whether the text is italic in `pages.NotionAnnotations.italic`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is italic as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-strikethrou-38a25a9c3313" title="Strikethrough" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.strikethrough`

            **Strikethrough.** Whether the text has strikethrough. It distinguishes the provider-defined strikethrough state or classification for the Notion annotation.

            * **Enables:** Filter Pages by whether the text has strikethrough in `pages.NotionAnnotations.strikethrough`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text has strikethrough as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-annotations-underline-eb401ac5c72b" title="Underline" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.annotations.underline`

            **Underline.** Whether the text is underlined. It distinguishes the provider-defined underline state or classification for the Notion annotation.

            * **Enables:** Filter Pages by whether the text is underlined in `pages.NotionAnnotations.underline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the text is underlined as a boolean on each Notion annotation; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-equation-3dc081f7e4e6" title="Equation" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.equation`

            **Equation.** Equation details, present when type is 'equation'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute equation in `pages.NotionRichText.equation` to the parent page; identify parent records where that nested equation object is absent.
            * **Interpretation:** Notion reports equation as a nested object on each Notion rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-equation-expression-a78428454ed1" title="Expression" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.equation.expression`

            **Expression.** The KaTeX expression string. It must be interpreted with the enclosing provider field name, type, or custom schema for the Notion equation.

            * **Enables:** Interpret `pages.NotionEquation.expression` with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
            * **Interpretation:** Notion reports expression under the enclosing custom or typed field contract on each Notion equation; compare it only with values from the same provider key and type.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-href-7d1fe2145020" title="Href" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.href`

            **Href.** URL link if the text is a hyperlink, or null. It locates the provider resource or path associated with the Notion rich text.

            * **Enables:** Associate each Notion rich text with the resource identified by href in `pages.NotionRichText.href`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports href as a resource locator for each Notion rich text; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-4843b379ff6e" title="Mention" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention`

            **Mention.** Mention details, present when type is 'mention'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute mention in `pages.NotionRichText.mention` to the parent page; identify parent records where that nested mention object is absent.
            * **Interpretation:** Notion reports mention as a nested object on each Notion rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-database-332dd3fb4ba9" title="Database" icon="brackets-curly" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.database`

            **Database.** Mentioned database reference. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute database in `pages.NotionMention.database` to the parent page; identify parent records where that nested database object is absent.
            * **Interpretation:** Notion reports database as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-database-id-12258b87b78c" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.database.id`

            **ID.** UUID of the mentioned page. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion mention object in Pages to the referenced Notion mention object through `pages.NotionMentionObject.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its Notion mention object namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-date-f3a53cec0d03" title="Date" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.date`

            **Date.** Date value, present when type is 'date'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute date in `pages.NotionMention.date` to the parent page; identify parent records where that nested date object is absent.
            * **Interpretation:** Notion reports date as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-date-end-8e2a61cac6a4" title="End" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.date.end`

            **End.** End date (ISO 8601 date or datetime), or null for single dates. It anchors the page on the provider's reported timeline.

            * **Enables:** Filter Pages by end in `pages.NotionDateValue.end`; pair that boundary with the corresponding start before measuring elapsed time.
            * **Interpretation:** Notion reports end as a timestamp on each Notion date value; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-date-start-99927da1ac4e" title="Start" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.date.start`

            **Start.** Start date (ISO 8601 date or datetime). It anchors the page on the provider's reported timeline.

            * **Enables:** Filter Pages by start in `pages.NotionDateValue.start`; pair that boundary with the corresponding end before measuring elapsed time.
            * **Interpretation:** Notion reports start as a timestamp on each Notion date value; timezone and precision follow this API field, and absence is not an inferred event time.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-date-time-zone-31d26dbb885e" title="Time Zone" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.date.time_zone`

            **Time Zone.** IANA time zone if the date includes a time component. It is needed to interpret companion dates and times for the Notion date value in the provider's intended zone.

            * **Enables:** Apply the zone in `pages.NotionDateValue.time_zone` when converting the page's companion start, end, or scheduled timestamps; do not infer it from locale.
            * **Interpretation:** Notion reports time zone as a timezone identifier for each Notion date value; supported IANA or provider-specific names and daylight-saving behavior must be preserved.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-link-preview-4d0751ea1fe9" title="Link Preview" icon="brackets-curly" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.link_preview`

            **Link Preview.** Link preview details. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute link preview in `pages.NotionMention.link_preview` to the parent page; identify parent records where that nested link preview object is absent.
            * **Interpretation:** Notion reports link preview as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-link-preview-ur-6b4e78ba741c" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.link_preview.url`

            **URL.** URL being previewed. It locates the provider resource or path associated with the Notion link preview.

            * **Enables:** Associate each Notion link preview with the resource identified by URL in `pages.NotionLinkPreview.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion link preview; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-page-acaddb4d3ad2" title="Page" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.page`

            **Page.** Mentioned page reference. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute page in `pages.NotionMention.page` to the parent page; identify parent records where that nested page object is absent.
            * **Interpretation:** Notion reports page as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-template-mentio-3197e599b870" title="Template Mention" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.template_mention`

            **Template Mention.** Template mention details. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute template mention in `pages.NotionMention.template_mention` to the parent page; identify parent records where that nested template mention object is absent.
            * **Interpretation:** Notion reports template mention as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-template-mentio-c5cad9d07bda" title="Template Mention Date" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.template_mention.template_mention_date`

            **Template Mention Date.** Template date keyword like 'today' or 'now'. It anchors the page on the provider's reported timeline.

            * **Enables:** Order Pages by template mention date in `pages.NotionMentionTemplateMention.template_mention_date` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports template mention date as a calendar date on each Notion mention template mention; its grain is one day and no time of day should be inferred.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-template-mentio-d093ac18e4c8" title="Template Mention User" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.template_mention.template_mention_user`

            **Template Mention User.** Template user keyword like 'me'. It supplies the template mention user profile facet used to reconcile or attribute the Notion mention template mention.

            * **Enables:** Reconcile the page's template mention user in `pages.NotionMentionTemplateMention.template_mention_user` with its provider profile or directory identity; confirm ambiguous matches with the stable provider ID.
            * **Interpretation:** Notion reports template mention user as a mutable profile or directory attribute on each Notion mention template mention; it may be absent, shared, or non-unique.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-template-mentio-a06d6f64b8a9" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.template_mention.type`

            **Type.** Template mention type: 'template\_mention\_date' or 'template\_mention\_user'. It distinguishes the provider-defined type state or classification for the Notion mention template mention.

            * **Enables:** Segment Notion mention template mention entries in Pages by type in `pages.NotionMentionTemplateMention.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion mention template mention; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-type-e361f81a479a" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.type`

            **Type.** Mention type: 'user', 'page', 'database', 'date', 'link\_preview', 'template\_mention'. It distinguishes the provider-defined type state or classification for the Notion mention.

            * **Enables:** Segment Notion mention entries in Pages by type in `pages.NotionMention.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion mention; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-mention-user-3bedda51a19a" title="User" icon="circle-info" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.mention.user`

            **User.** Mentioned user, present when type is 'user'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute user in `pages.NotionMention.user` to the parent page; identify parent records where that nested user object is absent.
            * **Interpretation:** Notion reports user as a nested object on each Notion mention; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-plain-text-95560ee72fa6" title="Plain Text" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.plain_text`

            **Plain Text.** Plain text content without annotations. It defines the content surface available for this page.

            * **Enables:** Locate Notion rich text records by plain text in `pages.NotionRichText.plain_text`; attribute each text match to its parent page and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-text-7d7fb573f076" title="Text" icon="circle-check" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.text`

            **Text.** Text content details, present when type is 'text'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute text in `pages.NotionRichText.text` to the parent page; identify parent records where that nested text object is absent.
            * **Interpretation:** Notion reports text as a nested object on each Notion rich text; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-text-content-a8eb60b7fc01" title="Content" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.text.content`

            **Content.** The actual text content. It defines the content surface available for this page.

            * **Enables:** Locate Notion text content records by content in `pages.NotionTextContent.content`; attribute each text match to its parent page and, when present, its reported author.
            * **Interpretation:** Notion returns the visible rich-text or block representation; external and uploaded file bytes are not embedded by this field.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-text-link-9b5c370a6cd5" title="Link" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.text.link`

            **Link.** Link object if the text contains a hyperlink, or null. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute link in `pages.NotionTextContent.link` to the parent page; identify parent records where that nested link object is absent.
            * **Interpretation:** Notion reports link as a nested object on each Notion text content; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-text-link-url-06137502f167" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.text.link.url`

            **URL.** URL of the link. It locates the provider resource or path associated with the Notion text content link.

            * **Enables:** Associate each Notion text content link with the resource identified by URL in `pages.NotionTextContentLink.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each Notion text content link; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-description-type-e97d8931216a" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.description.type`

            **Type.** Type of rich text: 'text', 'mention', or 'equation'. It distinguishes the provider-defined type state or classification for the Notion rich text.

            * **Enables:** Segment Notion rich text entries in Pages by type in `pages.NotionRichText.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion rich text; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-icon-a8e4263e19ee" title="Icon" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `pages.icon`

            **Icon.** Icon for the page or database (emoji or file), or null if none. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute icon in `pages.icon` to the parent page; identify parent records where that nested icon object is absent.
            * **Interpretation:** Notion reports icon as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-icon-emoji-422a30967ba8" title="Emoji" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `pages.icon.emoji`

            **Emoji.** Emoji character, present when type is 'emoji'. It distinguishes the provider-defined emoji state or classification for the Notion icon.

            * **Enables:** Filter Pages by the exact Notion-defined emoji in `pages.NotionIcon.emoji` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies emoji from its own taxonomy on each Notion icon; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-icon-external-baf42e9bf469" title="External" icon="triangle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.icon.external`

            **External.** External file details, present when type is 'external'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute external in `pages.NotionIcon.external` to the parent page; identify parent records where that nested external object is absent.
            * **Interpretation:** Notion reports external as a nested object on each Notion icon; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-icon-file-22c51030c37b" title="File" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `pages.icon.file`

            **File.** Notion-hosted file details, present when type is 'file'. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute file in `pages.NotionIcon.file` to the parent page; identify parent records where that nested file object is absent.
            * **Interpretation:** Notion reports file as a nested object on each Notion icon; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-icon-type-7e6b8bb88d57" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.icon.type`

            **Type.** Icon type: 'emoji', 'external', or 'file'. It distinguishes the provider-defined type state or classification for the Notion icon.

            * **Enables:** Segment Notion icon entries in Pages by type in `pages.NotionIcon.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion icon; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-id-2723264421fd" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.id`

            **ID.** Unique identifier for the page or database (UUID format). It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Match repeated page entries on ID in `pages.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its page namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-in-trash-9705261b342a" title="In Trash" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `pages.in_trash`

            **In Trash.** Whether the object is in the trash. It distinguishes the provider-defined in trash state or classification for the page.

            * **Enables:** Filter Pages by whether the object is in the trash in `pages.in_trash`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the object is in the trash as a boolean on each page; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-is-inline-7d5dbe572d36" title="Is Inline" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `pages.is_inline`

            **Is Inline.** Whether the database is inline (embedded within a page) rather than full-page. It distinguishes the provider-defined is inline state or classification for the page.

            * **Enables:** Filter Pages by whether the database is inline (embedded within a page) rather than full-page in `pages.is_inline`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports the database is inline (embedded within a page) rather than full-page as a boolean on each page; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-last-edited-by-ea57bdf51de5" title="Last Edited By" icon="code-merge" iconType="sharp-duotone-solid">
            Developer identifier: `pages.last_edited_by`

            **Last Edited By.** Partial user object representing who last edited this object. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute last edited by in `pages.last_edited_by` to the parent page; identify parent records where that nested last edited by object is absent.
            * **Interpretation:** Notion reports last edited by as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-last-edited-time-17af51561ec3" title="Last Edited Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `pages.last_edited_time`

            **Last Edited Time.** ISO 8601 timestamp when the object was last edited. It anchors the page on the provider's reported timeline.

            * **Enables:** Order Pages by last edited time in `pages.last_edited_time` and isolate records inside an exact provider reporting window.
            * **Interpretation:** Notion reports last edited time as a timestamp on each page; timezone and precision follow this API field, and absence is not an inferred event time. A connector directive uses this field to order records for latest-state or incremental processing.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-object-89df2958a4d6" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `pages.object`

            **Object.** Object type: 'page', 'database', or 'data\_source'. It distinguishes the provider-defined object state or classification for the page.

            * **Enables:** Segment page entries in Pages by object in `pages.object`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports object as a label from its own taxonomy on each page; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-aedf3b232e27" title="Parent" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent`

            **Parent.** Parent reference indicating where this object lives in the hierarchy. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute parent in `pages.parent` to the parent page; identify parent records where that nested parent object is absent.
            * **Interpretation:** Notion reports parent as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-block-id-5dc6edde1e4f" title="Block ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.block_id`

            **Block ID.** UUID of the parent block, if type is 'block\_id'. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Pages to the referenced block through `pages.NotionParent.block_id`; flag block ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports block ID as an identifier in its block namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-data-source-id-96934781c353" title="Data Source ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.data_source_id`

            **Data Source ID.** UUID of the parent data source, if type is 'data\_source\_id' (2026 Notion API). It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Pages to the referenced data source through `pages.NotionParent.data_source_id`; flag data source ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports data source ID as an identifier in its data source namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-database-id-b020cf915603" title="Database ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.database_id`

            **Database ID.** UUID of the parent database, if type is 'database\_id'. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Pages to the referenced database through `pages.NotionParent.database_id`; flag database ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports database ID as an identifier in its database namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-page-id-672d1e372233" title="Page ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.page_id`

            **Page ID.** UUID of the parent page, if type is 'page\_id'. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each Notion parent in Pages to the referenced page through `pages.NotionParent.page_id`; flag page ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports page ID as an identifier in its page namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-type-e3b90b749966" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.type`

            **Type.** Type of parent: 'database\_id', 'page\_id', 'workspace', or 'block\_id'. It distinguishes the provider-defined type state or classification for the Notion parent.

            * **Enables:** Segment Notion parent entries in Pages by type in `pages.NotionParent.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each Notion parent; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-parent-workspace-52a964343263" title="Workspace" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `pages.parent.workspace`

            **Workspace.** True if the parent is the workspace root. It distinguishes the provider-defined workspace state or classification for the Notion parent.

            * **Enables:** Filter Pages by whether true if the parent is the workspace root in `pages.NotionParent.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports true if the parent is the workspace root as a boolean on each Notion parent; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-properties-6cc7e47658aa" title="Properties" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `pages.properties`

            **Properties.** Page properties (title, status, assignee, dates, etc.) or database property schema definitions. Keys are property names, values are property value or definition objects. Is NotionPropertyValue. It preserves the nested context needed to interpret the parent page.

            * **Enables:** Attribute properties in `pages.properties` to the parent page; identify parent records where that nested properties object is absent.
            * **Interpretation:** Notion reports properties as a nested object on each page; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-public-url-099d05e9c4c3" title="Public URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `pages.public_url`

            **Public URL.** Public URL if the page is published to the web, or null. It locates the provider resource or path associated with the page.

            * **Enables:** Associate each page with the resource identified by public URL in `pages.public_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports public URL as a resource locator for each page; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-request-id-015970124619" title="Request ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `pages.request_id`

            **Request ID.** Request ID returned by the API for tracing. It provides the reference needed to connect the page to the corresponding provider object.

            * **Enables:** Connect each page in Pages to the referenced request through `pages.request_id`; flag request ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports request ID as an identifier in its request namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-title-d37cb57b7b4d" title="Title" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `pages.title`

            **Title.** Title rich text array (present on database objects). It preserves the nested context needed to interpret the parent page.

            * **Enables:** Search the returned title content in `pages.title` while preserving element order and attribution to the parent page.
            * **Interpretation:** Notion returns title as ordered content or provider-generated content metadata on each page; truncation, omission, and inaccessible source media can limit completeness.
          </Accordion>

          <Accordion id="provider-permission-field-notion-pages-url-9e532be64354" title="URL" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `pages.url`

            **URL.** URL to the page or database in Notion. It locates the provider resource or path associated with the page.

            * **Enables:** Associate each page with the resource identified by URL in `pages.url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports URL as a resource locator for each page; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-notion-users-b5d457b5d584" title="Users" icon="address-book" iconType="sharp-duotone-solid">
        Developer identifier: `users`

        **Users.** Workspace users.

        * **Enables:** Reconcile Notion people and bots to their identifiers, names, account type, email when visible, and bot-owner context.
        * **Scope:** Reads the records selected by Notion's `/v1/users` operation as a snapshot stream using full synchronization. Only pages and databases explicitly shared with the Notion integration, plus their reachable children, are visible. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. A later complete read can treat a previously seen record that is absent as removed.

        <AccordionGroup>
          <Accordion id="provider-permission-field-notion-users-avatar-url-ee20d2d1627a" title="Avatar URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `users.avatar_url`

            **Avatar URL.** URL of the user's avatar image, or null if not set. It locates the provider resource or path associated with the user.

            * **Enables:** Associate each user with the resource identified by avatar URL in `users.avatar_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports avatar URL as a resource locator for each user; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-91bad672a361" title="Bot" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot`

            **Bot.** Bot-specific details. Present only when type is 'bot'. It preserves the nested context needed to interpret the parent user.

            * **Enables:** Attribute bot in `users.bot` to the parent user; identify parent records where that nested bot object is absent.
            * **Interpretation:** Notion reports bot as a nested object on each user; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-e16935fd4455" title="Owner" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner`

            **Owner.** Information about who owns the bot. It preserves the nested context needed to interpret the parent user.

            * **Enables:** Attribute owner in `users.BotDetails.owner` to the parent user; identify parent records where that nested owner object is absent.
            * **Interpretation:** Notion reports owner as a nested object on each bot detail; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-type-4fabe12e0207" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.type`

            **Type.** The type of owner: 'workspace' or 'user'. It distinguishes the provider-defined type state or classification for the bot owner.

            * **Enables:** Segment bot owner entries in Users by type in `users.BotOwner.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each bot owner; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-37952d7ecb89" title="User" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user`

            **User.** The user who owns this bot. Present when type is 'user'. It preserves the nested context needed to interpret the parent user.

            * **Enables:** Attribute user in `users.BotOwner.user` to the parent user; identify parent records where that nested user object is absent.
            * **Interpretation:** Notion reports user as a nested object on each bot owner; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-avatar-url-5dfecd56544b" title="Avatar URL" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.avatar_url`

            **Avatar URL.** URL of the owning user's avatar image. It locates the provider resource or path associated with the bot owner user.

            * **Enables:** Associate each bot owner user with the resource identified by avatar URL in `users.BotOwnerUser.avatar_url`; verify the link resolves to the expected Notion object.
            * **Interpretation:** Notion reports avatar URL as a resource locator for each bot owner user; access still depends on viewer permissions and the URL may expire or change.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-id-2abe6ecb77d5" title="ID" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.id`

            **ID.** Unique identifier of the owning user. It provides the reference needed to connect the user to the corresponding provider object.

            * **Enables:** Connect each bot owner user in Users to the referenced bot owner user through `users.BotOwnerUser.id`; flag ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports ID as an identifier in its bot owner user namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-name-fea78607e7b4" title="Name" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.name`

            **Name.** Display name of the owning user. It gives the bot owner user a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each bot owner user with name from `users.BotOwnerUser.name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports name as display text for each bot owner user; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-object-47f7ba0baaf5" title="Object" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.object`

            **Object.** Always 'user' for user objects. It distinguishes the provider-defined object state or classification for the bot owner user.

            * **Enables:** Filter Users by the exact Notion-defined object in `users.BotOwnerUser.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each bot owner user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-person-1fe0ead9cc3f" title="Person" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.person`

            **Person.** Person details of the owning user, if applicable. It preserves the nested context needed to interpret the parent user.

            * **Enables:** Attribute person in `users.BotOwnerUser.person` to the parent user; identify parent records where that nested person object is absent.
            * **Interpretation:** Notion reports person as a nested object on each bot owner user; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-person-email-48b8705409e1" title="Email" icon="inbox" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.person.email`

            **Email.** Email address of the person user. It supplies the provider-reported address or location facet for the person detail, not a residency determination.

            * **Enables:** Attribute each person detail to a person or account by the exact email in `users.PersonDetails.email`; identify addresses that do not match the Notion directory.
            * **Interpretation:** Notion reports email as an address on each person detail; aliases, casing, and unverified addresses can prevent a one-to-one person match. A connector directive maps this field to a person's email identity.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-user-type-bbf7c95a1a4e" title="Type" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.user.type`

            **Type.** The type of the owning user (typically 'person'). It distinguishes the provider-defined type state or classification for the bot owner user.

            * **Enables:** Segment bot owner user entries in Users by type in `users.BotOwnerUser.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each bot owner user; preserve unknown labels rather than mapping them by assumption.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-owner-workspace-814f1af13368" title="Workspace" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.owner.workspace`

            **Workspace.** True if the bot is owned by the entire workspace. Present when type is 'workspace'. It distinguishes the provider-defined workspace state or classification for the bot owner.

            * **Enables:** Filter Users by whether true if the bot is owned by the entire workspace in `users.BotOwner.workspace`; count true, false, and missing results separately.
            * **Interpretation:** Notion reports true if the bot is owned by the entire workspace as a boolean on each bot owner; a missing field is unknown, not false.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-bot-workspace-name-2be2b8e34402" title="Workspace Name" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `users.bot.workspace_name`

            **Workspace Name.** Name of the workspace the bot belongs to. Present for workspace-level bots. It gives the bot detail a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each bot detail with workspace name from `users.BotDetails.workspace_name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports workspace name as display text for each bot detail; names are mutable and are not stable identities.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-id-4cbfb99c40bc" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `users.id`

            **ID.** Unique identifier for the user (UUIDv4). It provides the reference needed to connect the user to the corresponding provider object.

            * **Enables:** Match repeated user entries on ID in `users.id`; collapse only entries that share this declared transform key.
            * **Interpretation:** Notion reports ID as an identifier in its user namespace; it is not a universal identity outside Notion. The connector explicitly marks this field as a transform deduplication key. A connector directive maps this field to account identity.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-name-320cdbf835e0" title="Name" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `users.name`

            **Name.** Display name of the user. It gives the user a human-readable provider label while its identifier remains the stable reference.

            * **Enables:** Label each user with name from `users.name`; distinguish records that share that display name but have different Notion identifiers.
            * **Interpretation:** Notion reports name as display text for each user; names are mutable and are not stable identities. A connector directive maps this field to a person's display name.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-object-22910cc16a4e" title="Object" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `users.object`

            **Object.** Always 'user' for user objects. It distinguishes the provider-defined object state or classification for the user.

            * **Enables:** Filter Users by the exact Notion-defined object in `users.object` and preserve unknown values as distinct categories.
            * **Interpretation:** Notion supplies object from its own taxonomy on each user; preserve unknown and newly introduced labels.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-person-4f212a91a6ce" title="Person" icon="circle-exclamation" iconType="sharp-duotone-solid">
            Developer identifier: `users.person`

            **Person.** Person-specific details. Present only when type is 'person'. It preserves the nested context needed to interpret the parent user.

            * **Enables:** Attribute person in `users.person` to the parent user; identify parent records where that nested person object is absent.
            * **Interpretation:** Notion reports person as a nested object on each user; optional children may be absent from a valid response.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-person-email-dc5e77d0506e" title="Email" icon="inbox" iconType="sharp-duotone-solid">
            Developer identifier: `users.person.email`

            **Email.** Email address of the person user. It supplies the provider-reported address or location facet for the person, not a residency determination.

            * **Enables:** Attribute each person to a person or account by the exact email in `users.person.email`; identify addresses that do not match the Notion directory.
            * **Interpretation:** Notion reports email as an address on each person; aliases, casing, and unverified addresses can prevent a one-to-one person match. A connector directive maps this field to a person's email identity.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-request-id-00d520ff02a1" title="Request ID" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `users.request_id`

            **Request ID.** Request ID returned by the API for tracing purposes. It provides the reference needed to connect the user to the corresponding provider object.

            * **Enables:** Connect each user in Users to the referenced request through `users.request_id`; flag request ID values that do not resolve in that provider namespace.
            * **Interpretation:** Notion reports request ID as an identifier in its request namespace; it is not a universal identity outside Notion.
          </Accordion>

          <Accordion id="provider-permission-field-notion-users-type-e420bb7af5c6" title="Type" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `users.type`

            **Type.** Whether the user is a 'person' or 'bot'. It distinguishes the provider-defined type state or classification for the user.

            * **Enables:** Segment user entries in Users by type in `users.type`; compare counts only within the same Notion taxonomy.
            * **Interpretation:** Notion reports type as a label from its own taxonomy on each user; preserve unknown labels rather than mapping them by assumption.
          </Accordion>
        </AccordionGroup>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Troubleshooting">
    | Error                 | Meaning                   | Solution                                          |
    | --------------------- | ------------------------- | ------------------------------------------------- |
    | `unauthorized`        | Invalid token             | Verify token is correct                           |
    | `object_not_found`    | No access to object       | Share the page/database with the connection       |
    | `restricted_resource` | Insufficient capabilities | Enable required capability in connection settings |
    | `rate_limited`        | Too many requests         | Implement backoff                                 |

    #### Common Issues

    #### Connection can't find pages

    Content must be explicitly shared with the connection. Go to the page → **•••** → **Add connections** → select **Parable**.

    #### Missing user emails

    Ensure **Read user information including email addresses** is enabled in connection capabilities.

    **[Notion API](https://developers.notion.com/reference)** — Official API reference

    **[Integration Guide](https://developers.notion.com/docs/getting-started)** — Getting started guide
  </Tab>
</Tabs>