@notionhq/client 5.13.0 → 5.14.0

package/build/src/api-endpoints.d.ts

@@ -513,6 +513,26 @@ type BlockObjectWithSingleLevelOfChildrenRequest = {
     type?: "synced_block";
     object?: "block";
 };
+type BoardViewConfigRequest = {
+    type: "board";
+    group_by: GroupByConfigRequest;
+    sub_group_by?: GroupByConfigRequest | null;
+    properties?: Array<ViewPropertyConfigRequest> | null;
+    cover?: CoverConfigRequest | null;
+    cover_size?: "small" | "medium" | "large" | null;
+    cover_aspect?: "contain" | "cover" | null;
+    card_layout?: "list" | "compact" | null;
+};
+type BoardViewConfigResponse = {
+    type: "board";
+    group_by: GroupByConfigResponse;
+    sub_group_by?: GroupByConfigResponse;
+    properties?: Array<ViewPropertyConfigResponse>;
+    cover?: CoverConfigResponse;
+    cover_size?: "small" | "medium" | "large";
+    cover_aspect?: "contain" | "cover";
+    card_layout?: "list" | "compact";
+};
 export type BookmarkBlockObjectResponse = {
     type: "bookmark";
     bookmark: MediaContentWithUrlAndCaptionResponse;
@@ -607,6 +627,21 @@ type ButtonSimplePropertyValueResponse = {
     type: "button";
     button: EmptyObject;
 };
+type CalendarViewConfigRequest = {
+    type: "calendar";
+    date_property_id: string;
+    properties?: Array<ViewPropertyConfigRequest> | null;
+    view_range?: "week" | "month" | null;
+    show_weekends?: boolean | null;
+};
+type CalendarViewConfigResponse = {
+    type: "calendar";
+    date_property_id: string;
+    date_property_name?: string;
+    properties?: Array<ViewPropertyConfigResponse>;
+    view_range?: "week" | "month";
+    show_weekends?: boolean;
+};
 export type CalloutBlockObjectResponse = {
     type: "callout";
     callout: {
@@ -626,10 +661,103 @@ export type CalloutBlockObjectResponse = {
     /** @deprecated Use `in_trash` instead. Present for backwards compatibility with API versions prior to 2026-03-11. */
     archived: boolean;
 };
+type ChartAggregationRequest = {
+    aggregator: "count" | "count_values" | "sum" | "average" | "median" | "min" | "max" | "range" | "unique" | "empty" | "not_empty" | "percent_empty" | "percent_not_empty" | "checked" | "unchecked" | "percent_checked" | "percent_unchecked" | "earliest_date" | "latest_date" | "date_range";
+    property_id?: string;
+};
+type ChartAggregationResponse = {
+    aggregator: "count" | "count_values" | "sum" | "average" | "median" | "min" | "max" | "range" | "unique" | "empty" | "not_empty" | "percent_empty" | "percent_not_empty" | "checked" | "unchecked" | "percent_checked" | "percent_unchecked" | "earliest_date" | "latest_date" | "date_range";
+    property_id?: string;
+};
+type ChartReferenceLineRequest = {
+    value: number;
+    label: string;
+    color: "gray" | "lightgray" | "brown" | "yellow" | "orange" | "green" | "blue" | "purple" | "pink" | "red";
+    dash_style: "solid" | "dash";
+    id?: string;
+};
+type ChartReferenceLineResponse = {
+    id: string;
+    value: number;
+    label: string;
+    color: "gray" | "lightgray" | "brown" | "yellow" | "orange" | "green" | "blue" | "purple" | "pink" | "red";
+    dash_style: "solid" | "dash";
+};
+type ChartViewConfigRequest = {
+    type: "chart";
+    chart_type: "column" | "bar" | "line" | "donut" | "number";
+    x_axis?: GroupByConfigRequest | null;
+    y_axis?: ChartAggregationRequest | null;
+    x_axis_property_id?: string | null;
+    y_axis_property_id?: string | null;
+    value?: ChartAggregationRequest | null;
+    sort?: "manual" | "x_ascending" | "x_descending" | "y_ascending" | "y_descending" | null;
+    color_theme?: "gray" | "blue" | "yellow" | "green" | "purple" | "teal" | "orange" | "pink" | "red" | "auto" | "colorful" | null;
+    height?: "small" | "medium" | "large" | "extra_large" | null;
+    hide_empty_groups?: boolean | null;
+    legend_position?: "off" | "bottom" | "side" | null;
+    show_data_labels?: boolean | null;
+    axis_labels?: "none" | "x_axis" | "y_axis" | "both" | null;
+    grid_lines?: "none" | "horizontal" | "vertical" | "both" | null;
+    cumulative?: boolean | null;
+    smooth_line?: boolean | null;
+    hide_line_fill_area?: boolean | null;
+    group_style?: "normal" | "percent" | "side_by_side" | null;
+    y_axis_min?: number | null;
+    y_axis_max?: number | null;
+    donut_labels?: "none" | "value" | "name" | "name_and_value" | null;
+    hide_title?: boolean | null;
+    stack_by?: GroupByConfigRequest | null;
+    reference_lines?: Array<ChartReferenceLineRequest> | null;
+    caption?: string | null;
+    color_by_value?: boolean | null;
+};
+type ChartViewConfigResponse = {
+    type: "chart";
+    chart_type: "column" | "bar" | "line" | "donut" | "number";
+    x_axis?: GroupByConfigResponse | null;
+    y_axis?: ChartAggregationResponse | null;
+    x_axis_property_id?: string;
+    y_axis_property_id?: string;
+    value?: ChartAggregationResponse;
+    sort?: "manual" | "x_ascending" | "x_descending" | "y_ascending" | "y_descending";
+    color_theme?: "gray" | "blue" | "yellow" | "green" | "purple" | "teal" | "orange" | "pink" | "red" | "auto" | "colorful";
+    height?: "small" | "medium" | "large" | "extra_large";
+    hide_empty_groups?: boolean;
+    legend_position?: "off" | "bottom" | "side";
+    show_data_labels?: boolean;
+    axis_labels?: "none" | "x_axis" | "y_axis" | "both";
+    grid_lines?: "none" | "horizontal" | "vertical" | "both";
+    cumulative?: boolean;
+    smooth_line?: boolean;
+    hide_line_fill_area?: boolean;
+    group_style?: "normal" | "percent" | "side_by_side";
+    y_axis_min?: number | null;
+    y_axis_max?: number | null;
+    donut_labels?: "none" | "value" | "name" | "name_and_value";
+    hide_title?: boolean;
+    stack_by?: GroupByConfigResponse | null;
+    reference_lines?: Array<ChartReferenceLineResponse> | null;
+    caption?: string | null;
+    color_by_value?: boolean;
+};
 type CheckboxDatabasePropertyConfigResponse = {
     type: "checkbox";
     checkbox: EmptyObject;
 };
+type CheckboxGroupByConfigRequest = {
+    type: "checkbox";
+    property_id: string;
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type CheckboxGroupByConfigResponse = {
+    type: "checkbox";
+    property_id: string;
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
 type CheckboxPropertyConfigurationRequest = {
     type?: "checkbox";
     checkbox: EmptyObject;
@@ -808,6 +936,41 @@ type ContentWithTableRowRequest = {
 type ContentWithTableRowResponse = {
     cells: Array<Array<RichTextItemResponse>>;
 };
+type CoverConfigRequest = {
+    type: "page_cover" | "page_content" | "property";
+    property_id?: string;
+};
+type CoverConfigResponse = {
+    type: "page_cover" | "page_content" | "page_content_first" | "property";
+    property_id?: string;
+};
+type CreateDatabaseForViewRequest = {
+    parent: {
+        type: "page_id";
+        page_id: IdRequest;
+    };
+    position?: {
+        type: "after_block";
+        block_id: IdRequest;
+    };
+};
+type CreateViewQueryRequest = {
+    page_size?: number;
+};
+type CreateViewRequest = {
+    data_source_id: IdRequest;
+    name: string;
+    type: ViewTypeRequest;
+    database_id?: IdRequest;
+    view_id?: IdRequest;
+    filter?: ViewFilterRequest;
+    sorts?: ViewSortsRequest;
+    quick_filters?: Record<string, QuickFilterConditionRequest>;
+    create_database?: CreateDatabaseForViewRequest;
+    configuration?: ViewConfigRequest;
+    position?: ViewPositionRequest;
+    placement?: WidgetPlacementRequest;
+};
 type CreatedByDatabasePropertyConfigResponse = {
     type: "created_by";
     created_by: EmptyObject;
@@ -861,6 +1024,21 @@ type CustomEmojiResponse = {
     name: string;
     url: string;
 };
+export type DashboardRowResponse = {
+    id: string;
+    widgets: Array<DashboardWidgetResponse>;
+    height?: number;
+};
+type DashboardViewConfigResponse = {
+    type: "dashboard";
+    rows: Array<DashboardRowResponse>;
+};
+export type DashboardWidgetResponse = {
+    id: string;
+    view_id: string;
+    width?: number;
+    row_index?: number;
+};
 export type DataSourceObjectResponse = {
     object: "data_source";
     id: IdResponse;
@@ -891,6 +1069,28 @@ type DataSourceReferenceResponse = {
     id: IdResponse;
     name: string;
 };
+export type DataSourceViewObjectResponse = {
+    object: "view";
+    id: IdResponse;
+    parent: DatabaseParentResponse;
+    name: string;
+    type: "table" | "board" | "list" | "calendar" | "timeline" | "gallery" | "form" | "chart" | "map" | "dashboard";
+    created_time: string;
+    last_edited_time: string;
+    url: string;
+    data_source_id?: string | null;
+    created_by?: PartialUserObjectResponse | null;
+    last_edited_by?: PartialUserObjectResponse | null;
+    filter?: ViewFilterResponse | null;
+    sorts?: Array<ViewSortResponse> | null;
+    quick_filters?: Record<string, QuickFilterConditionResponse> | null;
+    configuration?: ViewConfigResponse | null;
+    dashboard_view_id?: string;
+};
+type DataSourceViewReferenceResponse = {
+    object: "view";
+    id: IdResponse;
+};
 export type DatabaseObjectResponse = {
     object: "database";
     id: IdResponse;
@@ -937,6 +1137,23 @@ type DateFormulaPropertyValueResponse = {
     type: "date";
     date: DateResponse | null;
 };
+type DateGroupByConfigRequest = {
+    type: "date" | "created_time" | "last_edited_time";
+    property_id: string;
+    group_by: "relative" | "day" | "week" | "month" | "year";
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+    start_day_of_week?: 0 | 1;
+};
+type DateGroupByConfigResponse = {
+    type: "date" | "created_time" | "last_edited_time";
+    property_id: string;
+    group_by: "relative" | "day" | "week" | "month" | "year";
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+    start_day_of_week?: 0 | 1;
+};
 type DatePartialRollupValueResponse = {
     type: "date";
     date: DateResponse | null;
@@ -990,6 +1207,11 @@ type DateSimplePropertyValueResponse = {
     type: "date";
     date: DateResponse | null;
 };
+export type DeletedViewQueryResponse = {
+    object: "view_query";
+    id: IdResponse;
+    deleted: boolean;
+};
 export type DividerBlockObjectResponse = {
     type: "divider";
     divider: EmptyObject;
@@ -1253,12 +1475,71 @@ type FilesSimplePropertyValueResponse = {
     type: "files";
     files: Array<InternalOrExternalFileWithNameResponse>;
 };
+type FormViewConfigRequest = {
+    type: "form";
+    is_form_closed?: boolean | null;
+    anonymous_submissions?: boolean | null;
+    submission_permissions?: "none" | "comment_only" | "reader" | "read_and_write" | "editor" | null;
+};
+type FormViewConfigResponse = {
+    type: "form";
+    is_form_closed?: boolean;
+    anonymous_submissions?: boolean;
+    submission_permissions?: "none" | "comment_only" | "reader" | "read_and_write" | "editor";
+};
+type FormulaCheckboxSubGroupByRequest = {
+    type: "checkbox";
+    sort: GroupSortRequest;
+};
+type FormulaCheckboxSubGroupByResponse = {
+    type: "checkbox";
+    sort: GroupSortResponse;
+};
 type FormulaDatabasePropertyConfigResponse = {
     type: "formula";
     formula: {
         expression: string;
     };
 };
+type FormulaDateSubGroupByRequest = {
+    type: "date";
+    group_by: "relative" | "day" | "week" | "month" | "year";
+    sort: GroupSortRequest;
+    start_day_of_week?: 0 | 1;
+};
+type FormulaDateSubGroupByResponse = {
+    type: "date";
+    group_by: "relative" | "day" | "week" | "month" | "year";
+    sort: GroupSortResponse;
+    start_day_of_week?: 0 | 1;
+};
+type FormulaGroupByConfigRequest = {
+    type: "formula";
+    property_id: string;
+    group_by: FormulaDateSubGroupByRequest | FormulaTextSubGroupByRequest | FormulaNumberSubGroupByRequest | FormulaCheckboxSubGroupByRequest;
+    hide_empty_groups?: boolean;
+};
+type FormulaGroupByConfigResponse = {
+    type: "formula";
+    property_id: string;
+    group_by: FormulaSubGroupByResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
+type FormulaNumberSubGroupByRequest = {
+    type: "number";
+    sort: GroupSortRequest;
+    range_start?: number;
+    range_end?: number;
+    range_size?: number;
+};
+type FormulaNumberSubGroupByResponse = {
+    type: "number";
+    sort: GroupSortResponse;
+    range_start?: number;
+    range_end?: number;
+    range_size?: number;
+};
 type FormulaPropertyConfigurationRequest = {
     type?: "formula";
     formula: {
@@ -1286,6 +1567,44 @@ type FormulaSimplePropertyValueResponse = {
     type: "formula";
     formula: FormulaPropertyValueResponse;
 };
+/**
+ * Sub-group-by configuration for formula properties based on result type.
+ */
+type FormulaSubGroupByResponse = FormulaDateSubGroupByResponse | FormulaTextSubGroupByResponse | FormulaNumberSubGroupByResponse | FormulaCheckboxSubGroupByResponse;
+type FormulaTextSubGroupByRequest = {
+    type: "text";
+    group_by: "exact" | "alphabet_prefix";
+    sort: GroupSortRequest;
+};
+type FormulaTextSubGroupByResponse = {
+    type: "text";
+    group_by: "exact" | "alphabet_prefix";
+    sort: GroupSortResponse;
+};
+type GalleryViewConfigRequest = {
+    type: "gallery";
+    properties?: Array<ViewPropertyConfigRequest> | null;
+    cover?: CoverConfigRequest | null;
+    cover_size?: "small" | "medium" | "large" | null;
+    cover_aspect?: "contain" | "cover" | null;
+    card_layout?: "list" | "compact" | null;
+};
+type GalleryViewConfigResponse = {
+    type: "gallery";
+    properties?: Array<ViewPropertyConfigResponse>;
+    cover?: CoverConfigResponse;
+    cover_size?: "small" | "medium" | "large";
+    cover_aspect?: "contain" | "cover";
+    card_layout?: "list" | "compact";
+};
+/**
+ * Group-by configuration based on property type.
+ */
+type GroupByConfigRequest = SelectGroupByConfigRequest | StatusGroupByConfigRequest | PersonGroupByConfigRequest | RelationGroupByConfigRequest | DateGroupByConfigRequest | TextGroupByConfigRequest | NumberGroupByConfigRequest | CheckboxGroupByConfigRequest | FormulaGroupByConfigRequest;
+/**
+ * Group-by configuration based on property type.
+ */
+type GroupByConfigResponse = SelectGroupByConfigResponse | StatusGroupByConfigResponse | PersonGroupByConfigResponse | RelationGroupByConfigResponse | DateGroupByConfigResponse | TextGroupByConfigResponse | NumberGroupByConfigResponse | CheckboxGroupByConfigResponse | FormulaGroupByConfigResponse;
 type GroupFilterOperatorArray = Array<PropertyOrTimestampFilter | {
     or: PropertyOrTimestampFilterArray;
 } | {
@@ -1301,6 +1620,12 @@ export type GroupObjectResponse = {
     object: "group";
     name: string | null;
 };
+type GroupSortRequest = {
+    type: "manual" | "ascending" | "descending";
+};
+type GroupSortResponse = {
+    type: "manual" | "ascending" | "descending";
+};
 type HeaderContentWithRichTextAndColorRequest = {
     rich_text: Array<RichTextItemRequest>;
     color?: ApiColor;
@@ -1502,10 +1827,31 @@ export type LinkToPageBlockObjectResponse = {
     /** @deprecated Use `in_trash` instead. Present for backwards compatibility with API versions prior to 2026-03-11. */
     archived: boolean;
 };
+type ListViewConfigRequest = {
+    type: "list";
+    properties?: Array<ViewPropertyConfigRequest> | null;
+};
+type ListViewConfigResponse = {
+    type: "list";
+    properties?: Array<ViewPropertyConfigResponse>;
+};
 type LocationPropertyConfigurationRequest = {
     type?: "location";
     location: EmptyObject;
 };
+type MapViewConfigRequest = {
+    type: "map";
+    height?: "small" | "medium" | "large" | "extra_large" | null;
+    map_by?: string | null;
+    properties?: Array<ViewPropertyConfigRequest> | null;
+};
+type MapViewConfigResponse = {
+    type: "map";
+    height?: "small" | "medium" | "large" | "extra_large";
+    map_by?: string;
+    map_by_property_name?: string;
+    properties?: Array<ViewPropertyConfigResponse>;
+};
 type MediaContentWithFileAndCaptionRequest = {
     external: ExternalFileRequest;
     type?: "external";
@@ -1680,6 +2026,25 @@ type NumberFormulaPropertyValueResponse = {
     type: "number";
     number: number | null;
 };
+type NumberGroupByConfigRequest = {
+    type: "number";
+    property_id: string;
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+    range_start?: number;
+    range_end?: number;
+    range_size?: number;
+};
+type NumberGroupByConfigResponse = {
+    type: "number";
+    property_id: string;
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+    range_start?: number;
+    range_end?: number;
+    range_size?: number;
+};
 type NumberPartialRollupValueResponse = {
     type: "number";
     number: number | null;
@@ -1756,6 +2121,7 @@ export type PageObjectResponse = {
     in_trash: boolean;
     /** @deprecated Use `in_trash` instead. Present for backwards compatibility with API versions prior to 2026-03-11. */
     archived: boolean;
+    is_archived: boolean;
     is_locked: boolean;
     url: string;
     public_url: string | null;
@@ -1777,6 +2143,10 @@ type PagePositionSchema = {
     type: "page_end";
 };
 type PagePropertyValueWithIdResponse = IdObjectResponse & (SimpleOrArrayPropertyValueResponse | PartialRollupPropertyResponse);
+type PageReferenceResponse = {
+    object: string;
+    id: IdResponse;
+};
 export type ParagraphBlockObjectResponse = {
     type: "paragraph";
     paragraph: ContentWithRichTextAndColorResponse;
@@ -1816,6 +2186,12 @@ export type PartialDataSourceObjectResponse = {
     id: IdResponse;
     properties: Record<string, DatabasePropertyConfigResponse>;
 };
+export type PartialDataSourceViewObjectResponse = {
+    object: "view";
+    id: IdResponse;
+    parent: DatabaseParentResponse;
+    type: "table" | "board" | "list" | "calendar" | "timeline" | "gallery" | "form" | "chart" | "map" | "dashboard";
+};
 export type PartialDatabaseObjectResponse = {
     object: "database";
     id: IdResponse;
@@ -1888,6 +2264,19 @@ export type PeoplePropertyItemObjectResponse = {
     object: "property_item";
     id: string;
 };
+type PersonGroupByConfigRequest = {
+    type: "person" | "created_by" | "last_edited_by";
+    property_id: string;
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type PersonGroupByConfigResponse = {
+    type: "person" | "created_by" | "last_edited_by";
+    property_id: string;
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
 export type PersonUserObjectResponse = {
     type: "person";
     person: {
@@ -2092,6 +2481,21 @@ type PropertyItemPropertyItemListResponse = {
 };
 type PropertyOrTimestampFilter = PropertyFilter | TimestampFilter;
 type PropertyOrTimestampFilterArray = Array<PropertyOrTimestampFilter>;
+type PropertySortResponse = {
+    property: string;
+    direction: "ascending" | "descending";
+};
+/**
+ * A property filter condition. Same shape as a property filter but without the
+ * "property" field (the hashmap key identifies the property). For example: { "select": {
+ * "equals": "High" } }.
+ */
+type QuickFilterConditionRequest = Record<string, never>;
+/**
+ * A property filter condition. Same shape as a property filter but without the
+ * "property" field. For example: { "select": { "equals": "High" } }.
+ */
+type QuickFilterConditionResponse = Record<string, never>;
 export type QuoteBlockObjectResponse = {
     type: "quote";
     quote: ContentWithRichTextAndColorResponse;
@@ -2115,6 +2519,19 @@ type RelationDatabasePropertyConfigResponse = {
     type: "relation";
     relation: DatabasePropertyRelationConfigResponse;
 };
+type RelationGroupByConfigRequest = {
+    type: "relation";
+    property_id: string;
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type RelationGroupByConfigResponse = {
+    type: "relation";
+    property_id: string;
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
 type RelationItemPropertyValueResponse = {
     id: IdRequest;
 };
@@ -2272,6 +2689,19 @@ type SelectDatabasePropertyConfigResponse = {
         options: Array<SelectPropertyResponse>;
     };
 };
+type SelectGroupByConfigRequest = {
+    type: "select" | "multi_select";
+    property_id: string;
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type SelectGroupByConfigResponse = {
+    type: "select" | "multi_select";
+    property_id: string;
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
 type SelectPropertyConfigurationRequest = {
     type?: "select";
     select: {
@@ -2309,6 +2739,10 @@ type SinglePropertyDatabasePropertyRelationConfigResponse = {
     type: "single_property";
     single_property: EmptyObject;
 };
+/**
+ * One of: `ascending`, `descending`
+ */
+type SortDirectionRequest = "ascending" | "descending";
 type StatusDatabasePropertyConfigResponse = {
     type: "status";
     status: {
@@ -2321,9 +2755,43 @@ type StatusDatabasePropertyConfigResponse = {
         }>;
     };
 };
+type StatusGroupByConfigRequest = {
+    type: "status";
+    property_id: string;
+    group_by: "group" | "option";
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type StatusGroupByConfigResponse = {
+    type: "status";
+    property_id: string;
+    group_by: "group" | "option";
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
+type StatusPropertyConfigRequest = {
+    options?: Array<{
+        name: string;
+        color?: SelectColor;
+        description?: string | null;
+    }>;
+};
+type StatusPropertyConfigUpdateRequest = {
+    options?: Array<{
+        color?: SelectColor;
+        description?: string | null;
+    } & ({
+        name: string;
+        id?: string;
+    } | {
+        id: string;
+        name?: string;
+    })>;
+};
 type StatusPropertyConfigurationRequest = {
     type?: "status";
-    status: EmptyObject;
+    status: StatusPropertyConfigRequest;
 };
 type StatusPropertyFilter = {
     equals: string;
@@ -2355,6 +2823,18 @@ type StringFormulaPropertyValueResponse = {
     string: string | null;
 };
 type StringRequest = string;
+type SubtaskConfigRequest = {
+    property_id?: string;
+    display_mode?: "show" | "hidden" | "flattened" | "disabled";
+    filter_scope?: "parents" | "parents_and_subitems" | "subitems";
+    toggle_column_id?: string;
+};
+type SubtaskConfigResponse = {
+    property_id?: string;
+    display_mode?: "show" | "hidden" | "flattened" | "disabled";
+    filter_scope?: "parents" | "parents_and_subitems" | "subitems";
+    toggle_column_id?: string;
+};
 export type SyncedBlockBlockObjectResponse = {
     type: "synced_block";
     synced_block: {
@@ -2433,6 +2913,24 @@ type TableRowRequest = {
     type?: "table_row";
     object?: "block";
 };
+type TableViewConfigRequest = {
+    type: "table";
+    properties?: Array<ViewPropertyConfigRequest> | null;
+    group_by?: GroupByConfigRequest | null;
+    subtasks?: SubtaskConfigRequest | null;
+    wrap_cells?: boolean;
+    frozen_column_index?: number;
+    show_vertical_lines?: boolean;
+};
+type TableViewConfigResponse = {
+    type: "table";
+    properties?: Array<ViewPropertyConfigResponse>;
+    group_by?: GroupByConfigResponse;
+    subtasks?: SubtaskConfigResponse;
+    wrap_cells?: boolean;
+    frozen_column_index?: number;
+    show_vertical_lines?: boolean;
+};
 export type TemplateBlockObjectResponse = {
     type: "template";
     template: {
@@ -2474,6 +2972,21 @@ type TemplateMentionUserTemplateMentionResponse = {
  * integrations, or UTC for internal integrations.
  */
 type TemplateTimezone = string;
+type TextGroupByConfigRequest = {
+    type: "text" | "title" | "url" | "email" | "phone_number";
+    property_id: string;
+    group_by: "exact" | "alphabet_prefix";
+    sort: GroupSortRequest;
+    hide_empty_groups?: boolean;
+};
+type TextGroupByConfigResponse = {
+    type: "text" | "title" | "url" | "email" | "phone_number";
+    property_id: string;
+    group_by: "exact" | "alphabet_prefix";
+    sort: GroupSortResponse;
+    property_name?: string;
+    hide_empty_groups?: boolean;
+};
 type TextPropertyFilter = {
     equals: string;
 } | {
@@ -2507,6 +3020,44 @@ export type TextRichTextItemResponse = {
     };
 };
 type TimeZoneRequest = string;
+type TimelineArrowsByRequest = {
+    property_id?: string | null;
+};
+type TimelineArrowsByResponse = {
+    property_id?: string | null;
+};
+type TimelinePreferenceRequest = {
+    zoom_level: "hours" | "day" | "week" | "bi_week" | "month" | "quarter" | "year" | "5_years";
+    center_timestamp?: number;
+};
+type TimelinePreferenceResponse = {
+    zoom_level: "hours" | "day" | "week" | "bi_week" | "month" | "quarter" | "year" | "5_years";
+    center_timestamp?: number;
+};
+type TimelineViewConfigRequest = {
+    type: "timeline";
+    date_property_id: string;
+    end_date_property_id?: string | null;
+    properties?: Array<ViewPropertyConfigRequest> | null;
+    show_table?: boolean | null;
+    table_properties?: Array<ViewPropertyConfigRequest> | null;
+    preference?: TimelinePreferenceRequest | null;
+    arrows_by?: TimelineArrowsByRequest | null;
+    color_by?: boolean | null;
+};
+type TimelineViewConfigResponse = {
+    type: "timeline";
+    date_property_id: string;
+    date_property_name?: string;
+    end_date_property_id?: string;
+    end_date_property_name?: string;
+    properties?: Array<ViewPropertyConfigResponse>;
+    show_table?: boolean;
+    table_properties?: Array<ViewPropertyConfigResponse>;
+    preference?: TimelinePreferenceResponse;
+    arrows_by?: TimelineArrowsByResponse;
+    color_by?: boolean;
+};
 type TimestampCreatedTimeFilter = {
     created_time: DatePropertyFilter;
     timestamp: "created_time";
@@ -2518,6 +3069,10 @@ type TimestampLastEditedTimeFilter = {
     timestamp: "last_edited_time";
     type?: "last_edited_time";
 };
+type TimestampSortResponse = {
+    timestamp: "created_time" | "last_edited_time";
+    direction: "ascending" | "descending";
+};
 type TitleArrayBasedPropertyValueResponse = {
     type: "title";
     title: Array<RichTextItemResponse>;
@@ -2655,6 +3210,13 @@ type UpdateMediaContentWithUrlAndCaptionRequest = {
     url?: string;
     caption?: Array<RichTextItemRequest>;
 };
+type UpdateViewRequest = {
+    name?: string;
+    filter?: ViewFilterRequest | null;
+    sorts?: ViewPropertySortsRequest | null;
+    quick_filters?: Record<string, QuickFilterConditionRequest | null> | null;
+    configuration?: ViewConfigRequest;
+};
 type UrlDatabasePropertyConfigResponse = {
     type: "url";
     url: EmptyObject;
@@ -2724,6 +3286,138 @@ export type VideoBlockObjectResponse = {
     /** @deprecated Use `in_trash` instead. Present for backwards compatibility with API versions prior to 2026-03-11. */
     archived: boolean;
 };
+/**
+ * View configuration, discriminated by the type field.
+ */
+type ViewConfigRequest = TableViewConfigRequest | BoardViewConfigRequest | CalendarViewConfigRequest | TimelineViewConfigRequest | GalleryViewConfigRequest | ListViewConfigRequest | MapViewConfigRequest | FormViewConfigRequest | ChartViewConfigRequest;
+/**
+ * View configuration, typed by view type (table, board, calendar, etc.).
+ */
+type ViewConfigResponse = TableViewConfigResponse | BoardViewConfigResponse | CalendarViewConfigResponse | TimelineViewConfigResponse | GalleryViewConfigResponse | ListViewConfigResponse | MapViewConfigResponse | FormViewConfigResponse | ChartViewConfigResponse | DashboardViewConfigResponse;
+/**
+ * Filter for the view. Uses the same format as the data source query filter (property
+ * filters, timestamp filters, or compound and/or filters). Simple property filters appear
+ * in the view's filter bar in the Notion UI. To filter by multiple values on a select or
+ * status property, use a compound "or" filter with separate "equals" conditions for each
+ * value.
+ */
+type ViewFilterRequest = Record<string, never>;
+/**
+ * Filter for the view. Can be a property filter (filter by property value), timestamp
+ * filter (filter by created_time or last_edited_time), or compound filter (combine
+ * filters with and/or logic). Compound filters support up to 2 levels of nesting.
+ */
+type ViewFilterResponse = (Record<string, unknown> & {
+    property: string;
+}) | (Record<string, unknown> & {
+    timestamp: "created_time" | "last_edited_time";
+}) | {
+    or?: Array<(Record<string, unknown> & {
+        property: string;
+    }) | (Record<string, unknown> & {
+        timestamp: "created_time" | "last_edited_time";
+    }) | {
+        or?: Array<(Record<string, unknown> & {
+            property: string;
+        }) | (Record<string, unknown> & {
+            timestamp: "created_time" | "last_edited_time";
+        })>;
+        and?: Array<(Record<string, unknown> & {
+            property: string;
+        }) | (Record<string, unknown> & {
+            timestamp: "created_time" | "last_edited_time";
+        })>;
+    }>;
+    and?: Array<(Record<string, unknown> & {
+        property: string;
+    }) | (Record<string, unknown> & {
+        timestamp: "created_time" | "last_edited_time";
+    }) | {
+        or?: Array<(Record<string, unknown> & {
+            property: string;
+        }) | (Record<string, unknown> & {
+            timestamp: "created_time" | "last_edited_time";
+        })>;
+        and?: Array<(Record<string, unknown> & {
+            property: string;
+        }) | (Record<string, unknown> & {
+            timestamp: "created_time" | "last_edited_time";
+        })>;
+    }>;
+};
+/**
+ * Position of the new view in the database's view tab bar.
+ */
+type ViewPositionRequest = {
+    type: "start";
+} | {
+    type: "end";
+} | {
+    type: "after_view";
+    view_id: IdRequest;
+};
+type ViewPropertyConfigRequest = {
+    property_id: string;
+    visible?: boolean;
+    width?: number;
+    wrap?: boolean;
+    status_show_as?: "select" | "checkbox";
+    card_property_width_mode?: "full_line" | "inline";
+    date_format?: "full" | "short" | "month_day_year" | "day_month_year" | "year_month_day" | "relative";
+    time_format?: "12_hour" | "24_hour" | "hidden";
+};
+type ViewPropertyConfigResponse = {
+    property_id: string;
+    property_name?: string;
+    visible?: boolean;
+    width?: number;
+    wrap?: boolean;
+    status_show_as?: "select" | "checkbox";
+    card_property_width_mode?: "full_line" | "inline";
+    date_format?: "full" | "short" | "month_day_year" | "day_month_year" | "year_month_day" | "relative";
+    time_format?: "12_hour" | "24_hour" | "hidden";
+};
+type ViewPropertySortRequest = {
+    property: string;
+    direction: SortDirectionRequest;
+};
+type ViewPropertySortsRequest = Array<ViewPropertySortRequest>;
+export type ViewQueryResponse = {
+    object: "view_query";
+    id: IdResponse;
+    view_id: IdResponse;
+    expires_at: string;
+    total_count: number;
+    results: Array<PageReferenceResponse>;
+    next_cursor: IdResponse | null;
+    has_more: boolean;
+};
+/**
+ * Sort for the view. Can be a property sort (with property and direction) or timestamp
+ * sort (with timestamp and direction).
+ */
+type ViewSortRequest = Record<string, never>;
+/**
+ * Sort for the view. Can sort by property or timestamp.
+ */
+type ViewSortResponse = PropertySortResponse | TimestampSortResponse;
+type ViewSortsRequest = Array<ViewSortRequest>;
+/**
+ * One of: `table`, `board`, `list`, `calendar`, `timeline`, `gallery`, `form`, `chart`,
+ * `map`, `dashboard`
+ */
+type ViewTypeRequest = "table" | "board" | "list" | "calendar" | "timeline" | "gallery" | "form" | "chart" | "map" | "dashboard";
+/**
+ * Where to place the new widget in the dashboard. "new_row" creates a new row,
+ * "existing_row" adds to an existing row side-by-side with other widgets.
+ */
+type WidgetPlacementRequest = {
+    type: "new_row";
+    row_index?: number;
+} | {
+    type: "existing_row";
+    row_index: number;
+};
 type WorkspaceParentForBlockBasedObjectResponse = {
     type: "workspace";
     workspace: true;
@@ -3024,6 +3718,7 @@ type UpdatePageBodyParameters = {
     in_trash?: boolean;
     /** @deprecated Use `in_trash` instead. */
     archived?: boolean;
+    is_archived?: boolean;
 };
 export type UpdatePageParameters = UpdatePagePathParameters & UpdatePageBodyParameters;
 export type UpdatePageResponse = PageObjectResponse | PartialPageObjectResponse;
@@ -3034,7 +3729,7 @@ export declare const updatePage: {
     readonly method: "patch";
     readonly pathParams: readonly ["page_id"];
     readonly queryParams: readonly [];
-    readonly bodyParams: readonly ["archived", "properties", "icon", "cover", "is_locked", "template", "erase_content", "in_trash"];
+    readonly bodyParams: readonly ["archived", "properties", "icon", "cover", "is_locked", "template", "erase_content", "in_trash", "is_archived"];
     readonly path: (p: UpdatePagePathParameters) => string;
 };
 type MovePagePathParameters = {
@@ -3513,7 +4208,7 @@ type UpdateDataSourceBodyParameters = {
         };
     } | {
         type?: "status";
-        status: EmptyObject;
+        status: StatusPropertyConfigUpdateRequest;
     } | {
         type?: "relation";
         relation: {
@@ -3988,6 +4683,149 @@ export declare const getFileUpload: {
     readonly bodyParams: readonly [];
     readonly path: (p: GetFileUploadPathParameters) => string;
 };
+type ListDatabaseViewsQueryParameters = {
+    database_id?: IdRequest;
+    data_source_id?: IdRequest;
+    start_cursor?: string;
+    page_size?: number;
+};
+export type ListDatabaseViewsParameters = ListDatabaseViewsQueryParameters;
+export type ListDatabaseViewsResponse = {
+    object: "list";
+    next_cursor: IdResponse | null;
+    has_more: boolean;
+    results: Array<DataSourceViewReferenceResponse>;
+    type: "view";
+    view: EmptyObject;
+};
+/**
+ * List views
+ */
+export declare const listDatabaseViews: {
+    readonly method: "get";
+    readonly pathParams: readonly [];
+    readonly queryParams: readonly ["database_id", "data_source_id", "start_cursor", "page_size"];
+    readonly bodyParams: readonly [];
+    readonly path: () => string;
+};
+type CreateViewBodyParameters = CreateViewRequest;
+export type CreateViewParameters = CreateViewBodyParameters;
+export type CreateViewResponse = PartialDataSourceViewObjectResponse | DataSourceViewObjectResponse;
+/**
+ * Create a view
+ */
+export declare const createView: {
+    readonly method: "post";
+    readonly pathParams: readonly [];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: () => string;
+};
+type GetViewPathParameters = {
+    view_id: IdRequest;
+};
+export type GetViewParameters = GetViewPathParameters;
+export type GetViewResponse = PartialDataSourceViewObjectResponse | DataSourceViewObjectResponse;
+/**
+ * Retrieve a view
+ */
+export declare const getView: {
+    readonly method: "get";
+    readonly pathParams: readonly ["view_id"];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: (p: GetViewPathParameters) => string;
+};
+type UpdateViewPathParameters = {
+    view_id: IdRequest;
+};
+type UpdateViewBodyParameters = UpdateViewRequest;
+export type UpdateViewParameters = UpdateViewPathParameters & UpdateViewBodyParameters;
+export type UpdateViewResponse = PartialDataSourceViewObjectResponse | DataSourceViewObjectResponse;
+/**
+ * Update a view
+ */
+export declare const updateView: {
+    readonly method: "patch";
+    readonly pathParams: readonly ["view_id"];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: (p: UpdateViewPathParameters) => string;
+};
+type DeleteViewPathParameters = {
+    view_id: IdRequest;
+};
+export type DeleteViewParameters = DeleteViewPathParameters;
+export type DeleteViewResponse = PartialDataSourceViewObjectResponse;
+/**
+ * Delete a view
+ */
+export declare const deleteView: {
+    readonly method: "delete";
+    readonly pathParams: readonly ["view_id"];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: (p: DeleteViewPathParameters) => string;
+};
+type CreateViewQueryPathParameters = {
+    view_id: IdRequest;
+};
+type CreateViewQueryBodyParameters = CreateViewQueryRequest;
+export type CreateViewQueryParameters = CreateViewQueryPathParameters & CreateViewQueryBodyParameters;
+export type CreateViewQueryResponse = ViewQueryResponse;
+/**
+ * Create a view query
+ */
+export declare const createViewQuery: {
+    readonly method: "post";
+    readonly pathParams: readonly ["view_id"];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: (p: CreateViewQueryPathParameters) => string;
+};
+type GetViewQueryResultsPathParameters = {
+    view_id: IdRequest;
+    query_id: IdRequest;
+};
+type GetViewQueryResultsQueryParameters = {
+    start_cursor?: string;
+    page_size?: number;
+};
+export type GetViewQueryResultsParameters = GetViewQueryResultsPathParameters & GetViewQueryResultsQueryParameters;
+export type GetViewQueryResultsResponse = {
+    object: "list";
+    next_cursor: IdResponse | null;
+    has_more: boolean;
+    results: Array<PartialPageObjectResponse>;
+    type: "page";
+    page: EmptyObject;
+};
+/**
+ * Get view query results
+ */
+export declare const getViewQueryResults: {
+    readonly method: "get";
+    readonly pathParams: readonly ["view_id", "query_id"];
+    readonly queryParams: readonly ["start_cursor", "page_size"];
+    readonly bodyParams: readonly [];
+    readonly path: (p: GetViewQueryResultsPathParameters) => string;
+};
+type DeleteViewQueryPathParameters = {
+    view_id: IdRequest;
+    query_id: IdRequest;
+};
+export type DeleteViewQueryParameters = DeleteViewQueryPathParameters;
+export type DeleteViewQueryResponse = DeletedViewQueryResponse;
+/**
+ * Delete a view query
+ */
+export declare const deleteViewQuery: {
+    readonly method: "delete";
+    readonly pathParams: readonly ["view_id", "query_id"];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly path: (p: DeleteViewQueryPathParameters) => string;
+};
 type OauthTokenBodyParameters = {
     grant_type: "authorization_code";
     code: string;