Views API Launch

Notion has introduced the /v1/views API, a major expansion enabling developers to programmatically manage database views—the same view presets users create in the Notion UI. This brings database view automation to the API for the first time.

Supported Operations

The new API includes eight endpoints:

• CRUD operations: Create, retrieve, update, and delete views on any database
• List views: Retrieve views for a specific database or across the workspace by data source
• Query views: Fetch pages using a view's saved filter and sort configuration, with pagination support

View Configuration Support

The API supports all 10 view types: table, board, calendar, timeline, gallery, list, form, chart, map, and dashboard. Views can be configured with:

• Filters and sorts
• Quick filters
• Type-specific layout settings (grouping, cover images, subtasks, chart options)
• Dashboard grid layout with full widget placement control

Webhooks and SDK Support

Three new webhook events are now available on API version 2025-09-03 and later:

• view.created
• view.updated
• view.deleted

The official JavaScript SDK (@notionhq/client v5.14.0) adds notion.views.* and notion.views.queries.* methods for easy integration.

Status Property Creation Support

Status properties can now be created and modified through the API and Notion MCP, removing a previous read-only limitation. Developers can:

• Create status properties with default or custom options
• Update existing status properties with new options
• Use the STATUS column type in MCP schema definitions

Additional Improvements

API Version 2026-03-11

A new API version introduces three breaking changes to modernize the API:

• after → position: The Append block children endpoint now uses a position object for more flexible block placement
• archived → in_trash: All endpoints now use in_trash instead of the deprecated archived field
• transcription → meeting_notes: Block type renamed for clarity

An upgrade guide is available for migrating integrations. SDK version v5.12.0 supports the new version.

Notion MCP Enhancements

Two new tools extend the Notion Model Context Protocol:

• notion-create-view: Create new database views with full configuration options
• notion-update-view: Modify existing view configurations using view URIs, Notion URLs, or UUIDs

Markdown Content API Improvements

The Update page markdown endpoint now supports:

• update_content: Targeted search-and-replace edits for precise modifications
• replace_content: Full page content replacement