Integrations
Notion managed operation reference
Every Notion operation, SDK method, policy identity and source
Contract 2026-11-12 exposes 58 operations. Install @alter-ai/notion or alter-sdk-notion and construct NotionIntegration with the application’s core client and connection. Methods below are relative to that provider client.
See usage and versioning. Select an operation below for its complete input/output fields and Python/TypeScript examples, or browse every schema. Native OpenAPI specification for this contract: notion.2026-11-12.openapi.json. It describes the provider’s own API; call it through the provider SDK so policy, approvals and audit apply.
Persist a pending call’s approvalId / approval_id, then call the package client’s resume(id) after restart and await wait(). The stored provider/version must match this installed publication; its operation selects the validator. See restart-safe approvals.
| Operation | TypeScript | Python | Policy ID | Response |
|---|---|---|---|---|
| notion.agent_batch | agents.agentBatch | agents.agent_batch | agent_batch | application/json |
| notion.cancel_session | sessions.cancelSession | sessions.cancel_session | cancel_session | application/json |
| notion.complete_file_upload | fileUploads.completeFileUpload | file_uploads.complete_file_upload | complete_file_upload | application/json |
| notion.create_a_comment | comments.createAComment | comments.create_a_comment | create_a_comment | application/json |
| notion.create_a_database | dataSources.createADatabase | data_sources.create_a_database | create_a_database | application/json |
| notion.create_database | databases.createDatabase | databases.create_database | create_database | application/json |
| notion.create_file | fileUploads.createFile | file_uploads.create_file | create_file | application/json |
| notion.create_meeting_note | meetingNotes.createMeetingNote | meeting_notes.create_meeting_note | create_meeting_note | application/json |
| notion.create_view_query | views.createViewQuery | views.create_view_query | create_view_query | application/json |
| notion.delete_a_block | blocks.deleteABlock | blocks.delete_a_block | delete_a_block | application/json |
| notion.delete_a_comment | comments.deleteAComment | comments.delete_a_comment | delete_a_comment | application/json |
| notion.delete_agent | agents.deleteAgent | agents.delete_agent | delete_agent | application/json |
| notion.delete_view | views.deleteView | views.delete_view | delete_view | application/json |
| notion.delete_view_query | views.deleteViewQuery | views.delete_view_query | delete_view_query | application/json |
| notion.get_agent | agents.getAgent | agents.get_agent | get_agent | application/json |
| notion.get_agent_insights | agents.getAgentInsights | agents.get_agent_insights | get_agent_insights | application/json |
| notion.get_block_children | blocks.getBlockChildren | blocks.get_block_children | get_block_children | application/json |
| notion.get_plugin_directory | agentSkills.getPluginDirectory | agent_skills.get_plugin_directory | get_plugin_directory | application/json |
| notion.get_self | users.getSelf | users.get_self | get_self | application/json |
| notion.get_skill_directory | agentSkills.getSkillDirectory | agent_skills.get_skill_directory | get_skill_directory | application/json |
| notion.get_user | users.getUser | users.get_user | get_user | application/json |
| notion.get_users | users.getUsers | users.get_users | get_users | application/json |
| notion.get_view_query_results | views.getViewQueryResults | views.get_view_query_results | get_view_query_results | application/json |
| notion.list_comments | comments.listComments | comments.list_comments | list_comments | application/json |
| notion.list_custom_emojis | customEmojis.listCustomEmojis | custom_emojis.list_custom_emojis | list_custom_emojis | application/json |
| notion.list_data_source_templates | dataSources.listDataSourceTemplates | data_sources.list_data_source_templates | list_data_source_templates | application/json |
| notion.list_file_uploads | fileUploads.listFileUploads | file_uploads.list_file_uploads | list_file_uploads | application/json |
| notion.list_skills_plugins | agentSkills.listSkillsPlugins | agent_skills.list_skills_plugins | list_skills_plugins | application/json |
| notion.list_views | views.listViews | views.list_views | list_views | application/json |
| notion.patch_block_children | blocks.patchBlockChildren | blocks.patch_block_children | patch_block_children | application/json |
| notion.patch_page | pages.patchPage | pages.patch_page | patch_page | application/json |
| notion.post_database_query | dataSources.postDatabaseQuery | data_sources.post_database_query | post_database_query | application/json |
| notion.post_page | pages.postPage | pages.post_page | post_page | application/json |
| notion.post_search | search.postSearch | search.post_search | post_search | application/json |
| notion.query_agents | agents.queryAgents | agents.query_agents | query_agents | application/json |
| notion.query_meeting_notes | meetingNotes.queryMeetingNotes | meeting_notes.query_meeting_notes | query_meeting_notes | application/json |
| notion.query_session_events | sessions.querySessionEvents | sessions.query_session_events | query_session_events | application/json |
| notion.query_sessions | sessions.querySessions | sessions.query_sessions | query_sessions | application/json |
| notion.retrieve_a_block | blocks.retrieveABlock | blocks.retrieve_a_block | retrieve_a_block | application/json |
| notion.retrieve_a_data_source | dataSources.retrieveADataSource | data_sources.retrieve_a_data_source | retrieve_a_data_source | application/json |
| notion.retrieve_a_page | pages.retrieveAPage | pages.retrieve_a_page | retrieve_a_page | application/json |
| notion.retrieve_a_page_property | pages.retrieveAPageProperty | pages.retrieve_a_page_property | retrieve_a_page_property | application/json |
| notion.retrieve_a_view | views.retrieveAView | views.retrieve_a_view | retrieve_a_view | application/json |
| notion.retrieve_async_task | asyncTasks.retrieveAsyncTask | async_tasks.retrieve_async_task | retrieve_async_task | application/json |
| notion.retrieve_comment | comments.retrieveComment | comments.retrieve_comment | retrieve_comment | application/json |
| notion.retrieve_database | databases.retrieveDatabase | databases.retrieve_database | retrieve_database | application/json |
| notion.retrieve_file_upload | fileUploads.retrieveFileUpload | file_uploads.retrieve_file_upload | retrieve_file_upload | application/json |
| notion.retrieve_page_markdown | pages.retrievePageMarkdown | pages.retrieve_page_markdown | retrieve_page_markdown | application/json |
| notion.retrieve_session | sessions.retrieveSession | sessions.retrieve_session | retrieve_session | application/json |
| notion.update_a_block | blocks.updateABlock | blocks.update_a_block | update_a_block | application/json |
| notion.update_a_comment | comments.updateAComment | comments.update_a_comment | update_a_comment | application/json |
| notion.update_agent | agents.updateAgent | agents.update_agent | update_agent | application/json |
| notion.update_agent_credit_limit | agents.updateAgentCreditLimit | agents.update_agent_credit_limit | update_agent_credit_limit | application/json |
| notion.update_agent_status | agents.updateAgentStatus | agents.update_agent_status | update_agent_status | application/json |
| notion.update_database | databases.updateDatabase | databases.update_database | update_database | application/json |
| notion.update_page_markdown | pages.updatePageMarkdown | pages.update_page_markdown | update_page_markdown | application/json |
| notion.upload_file | fileUploads.uploadFile | file_uploads.upload_file | upload_file | application/json |
| notion.upload_skill | agentSkills.uploadSkill | agent_skills.upload_skill | upload_skill | application/json |