# Notion ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server ## Docs - [Welcome](https://notion.ferndocs.com/get-started/welcome.md) - [Notion API Overview](https://notion.ferndocs.com/docs/getting-started.md): Discover how to leverage Notion's Public API to build integrations. - [Build your first integration](https://notion.ferndocs.com/docs/create-a-notion-integration.md): Make your first request to the Notion API. - [Authorization](https://notion.ferndocs.com/docs/authorization.md): This guide describes the authorization flows for internal and public Notion integrations. - [Publishing to Notion’s Integration Gallery](https://notion.ferndocs.com/docs/publishing-integrations-to-notions-integration-gallery.md): - [Upgrading to Version 2025-09-03](https://notion.ferndocs.com/docs/upgrade-guide-2025-09-03.md): Learn how to upgrade your Notion API integrations to the latest API version - [FAQs: Version 2025-09-03](https://notion.ferndocs.com/docs/upgrade-faqs-2025-09-03.md): Commonly asked questions about data sources and how to migrate to Notion's API version 2025-09-03 - [Notion MCP](https://notion.ferndocs.com/docs/mcp.md): Learn how to connect AI agents to your Notion workspace. - [Connecting to Notion MCP](https://notion.ferndocs.com/docs/get-started-with-mcp.md): Learn how to get started and plug Notion into your AI tool. - [Supported tools](https://notion.ferndocs.com/docs/mcp-supported-tools.md): Learn what you can do with Notion MCP tools. - [Security best practices](https://notion.ferndocs.com/docs/mcp-security-best-practices.md): Learn how to keep your workspace secure when using Notion MCP. - [Hosting a local MCP server](https://notion.ferndocs.com/docs/hosting-open-source-mcp.md): Learn how and when to use the open-source Notion MCP server. - [Common MCP clients](https://notion.ferndocs.com/docs/common-mcp-clients.md): - [Working with page content](https://notion.ferndocs.com/docs/working-with-page-content.md): Learn about page content and how to add or retrieve it with the Notion API. - [Working with databases](https://notion.ferndocs.com/docs/working-with-databases.md): Learn about data source schemas, querying data sources, and more. - [Working with comments](https://notion.ferndocs.com/docs/working-with-comments.md): Learn how to add and retrieve comments with the Notion API. - [Working with files and media](https://notion.ferndocs.com/docs/working-with-files-and-media.md): Learn how to add or retrieve files and media from Notion pages. - [Uploading small files](https://notion.ferndocs.com/docs/uploading-small-files.md): Learn how to send and attach files up to 20 MB using the Notion API. - [Retrieving existing files](https://notion.ferndocs.com/docs/retrieving-files.md): Learn how to get a download link for files in the Notion API. - [Uploading larger files](https://notion.ferndocs.com/docs/sending-larger-files.md): Learn how to send files larger than 20 MB in multiple parts. - [Importing external files](https://notion.ferndocs.com/docs/importing-external-files.md): Learn how to migrate files from an external URL to Notion. - [Introduction](https://notion.ferndocs.com/docs/link-previews.md): This guide introduces Link Previews, how they work, and what you need to build them. - [Build a Link Preview integration](https://notion.ferndocs.com/docs/build-a-link-preview-integration.md): Follow this step-by-step guide to create your first Link Preview. - [Best practices for handling API keys](https://notion.ferndocs.com/docs/best-practices-for-handling-api-keys.md): Learn how to manage and secure your Notion API tokens. - [Historical changelog](https://notion.ferndocs.com/docs/historical-changelog.md): View an archive of Notion Developers updates prior to September 2023 - [Historical changelog (all entries)](https://notion.ferndocs.com/docs/historical-changelog/llms.txt) - [Introduction](https://notion.ferndocs.com/reference/intro.md): - [Integration capabilities](https://notion.ferndocs.com/reference/capabilities.md): - [Webhooks](https://notion.ferndocs.com/reference/webhooks.md): - [Event types & delivery](https://notion.ferndocs.com/reference/webhooks-events-delivery.md): - [Request limits](https://notion.ferndocs.com/reference/request-limits.md): - [Status codes](https://notion.ferndocs.com/reference/status-codes.md): Responses from the API use HTTP response codes to indicate general classes of success and error. - [Versioning](https://notion.ferndocs.com/reference/versioning.md): - [Changes by version](https://notion.ferndocs.com/reference/changes-by-version.md): - [Block](https://notion.ferndocs.com/reference/block.md): - [Rich text](https://notion.ferndocs.com/reference/rich-text.md): - [Page](https://notion.ferndocs.com/reference/page.md): - [Page properties](https://notion.ferndocs.com/reference/page-property-values.md): - [Page property items](https://notion.ferndocs.com/docs/property-item-object.md): - [Database](https://notion.ferndocs.com/reference/database.md): Learn more about Notion's database object. - [Data source](https://notion.ferndocs.com/reference/data-source.md): Learn more about Notion's data source object. - [Data source properties](https://notion.ferndocs.com/reference/property-object.md): Data source property objects are rendered in the Notion UI as data columns. - [Comment](https://notion.ferndocs.com/reference/comment-object.md): - [Comment attachment](https://notion.ferndocs.com/reference/comment-attachment.md): - [Comment display name](https://notion.ferndocs.com/reference/comment-display-name.md): - [File](https://notion.ferndocs.com/reference/file-object.md): - [File Upload](https://notion.ferndocs.com/reference/file-upload.md): The [File Upload object](#object-properties) tracks the lifecycle of a file uploaded to Notion in the API. - [User](https://notion.ferndocs.com/reference/user.md): - [Parent](https://notion.ferndocs.com/reference/parent-object.md): Learn more about different parent objects that link together a workspace's entities in Notion's API. - [Emoji](https://notion.ferndocs.com/reference/emoji-object.md): - [Unfurl attribute (Link Previews)](https://notion.ferndocs.com/reference/unfurl-attribute-object.md): A Link Preview is created from an array of unfurl attribute objects. - [Authentication](https://notion.ferndocs.com/authentication.md): - [Filter data source entries](https://notion.ferndocs.com/reference/filter-data-source-entries.md): - [Sort data source entries](https://notion.ferndocs.com/reference/sort-data-source-entries.md): - [Search optimizations and limitations](https://notion.ferndocs.com/reference/search-optimizations-and-limitations.md): - [Changelog](https://notion.ferndocs.com/page/changelog/llms.txt) - [Introductory](https://notion.ferndocs.com/page/examples/by-experience/introductory.md) - [Intermediate](https://notion.ferndocs.com/page/examples/by-experience/intermediate.md) - [Advanced](https://notion.ferndocs.com/page/examples/by-experience/advanced.md) ## API Docs - Endpoints > Authentication [Create a token](https://notion.ferndocs.com/authentication/create-a-token.md) - Endpoints > Authentication [Introspect token](https://notion.ferndocs.com/authentication/introspect-token.md) - Endpoints > Authentication [Revoke token](https://notion.ferndocs.com/authentication/revoke-token.md) - Endpoints > Blocks [Retrieve block children](https://notion.ferndocs.com/reference/get-block-children.md) - Endpoints > Blocks [Append block children](https://notion.ferndocs.com/reference/patch-block-children.md) - Endpoints > Blocks [Retrieve a block](https://notion.ferndocs.com/reference/retrieve-a-block.md) - Endpoints > Blocks [Delete a block](https://notion.ferndocs.com/reference/delete-a-block.md) - Endpoints > Blocks [Update a block](https://notion.ferndocs.com/reference/update-a-block.md) - Endpoints > Pages [Retrieve a page](https://notion.ferndocs.com/reference/retrieve-a-page.md) - Endpoints > Pages [Update page properties](https://notion.ferndocs.com/reference/patch-page.md) - Endpoints > Pages [Create a page](https://notion.ferndocs.com/reference/post-page.md) - Endpoints > Pages [Retrieve a page property item](https://notion.ferndocs.com/reference/retrieve-a-page-property.md) - Endpoints > Databases [Create a database](https://notion.ferndocs.com/reference/create-a-database.md) - Endpoints > Databases [Retrieve a database](https://notion.ferndocs.com/reference/retrieve-a-database.md) - Endpoints > Databases [Update a database](https://notion.ferndocs.com/reference/update-a-database.md) - Endpoints > Data sources [Create a data source](https://notion.ferndocs.com/reference/create-a-data-source.md) - Endpoints > Data sources [Retrieve a data source](https://notion.ferndocs.com/reference/retrieve-a-data-source.md) - Endpoints > Data sources [Update a data source](https://notion.ferndocs.com/reference/update-a-data-source.md) - Endpoints > Data sources [Query a data source](https://notion.ferndocs.com/reference/query-a-data-source.md) - Endpoints > Databases (deprecated) [Query a database](https://notion.ferndocs.com/reference/post-database-query.md) - Endpoints > Databases (deprecated) [List databases (deprecated)](https://notion.ferndocs.com/reference/get-databases.md) - Endpoints > Databases (deprecated) [Create a database](https://notion.ferndocs.com/reference/database-create.md) - Endpoints > Databases (deprecated) [Retrieve a database](https://notion.ferndocs.com/reference/database-retrieve.md) - Endpoints > Databases (deprecated) [Update a database](https://notion.ferndocs.com/reference/database-update.md) - Endpoints > Comments [List comments](https://notion.ferndocs.com/reference/list-comments.md) - Endpoints > Comments [Create comment](https://notion.ferndocs.com/reference/create-a-comment.md) - Endpoints > Comments [Retrieve a comment](https://notion.ferndocs.com/reference/retrieve-comment.md) - Endpoints > File uploads [List file uploads](https://notion.ferndocs.com/reference/list-file-uploads.md) - Endpoints > File uploads [Create a file upload](https://notion.ferndocs.com/reference/create-a-file-upload.md) - Endpoints > File uploads [Send a file upload](https://notion.ferndocs.com/reference/send-a-file-upload.md) - Endpoints > File uploads [Complete a file upload](https://notion.ferndocs.com/reference/complete-a-file-upload.md) - Endpoints > File uploads [Retrieve a file upload](https://notion.ferndocs.com/reference/retrieve-a-file-upload.md) - Endpoints > Search [Search by title](https://notion.ferndocs.com/reference/post-search.md) - Endpoints > Users [Retrieve a user](https://notion.ferndocs.com/reference/get-user.md) - Endpoints > Users [List all users](https://notion.ferndocs.com/reference/get-users.md) - Endpoints > Users [Retrieve your token's bot user](https://notion.ferndocs.com/reference/get-self.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://notion.ferndocs.com/openapi.json) - [OpenAPI YAML](https://notion.ferndocs.com/openapi.yaml)