Services

External API integrations (pure API calls only).

Services should:

• Make direct API calls to external systems
• Be pure functions that handle HTTP transport layer (response.ok)
• Return consistent { success: boolean, data?: any, error?: string } format
• NOT handle environment variables, business logic, or orchestrate multiple calls

• getDatabases() - Search for all Notion databases
• getDatabaseById(databaseId) - Retrieve specific database metadata
• getPageById(pageId) - Retrieve specific page from Notion
• getPageBlocks(pageId) - Retrieve page content blocks from Notion (with nested blocks recursively)
• getMultiplePages(pageIds) - Batch retrieve multiple pages with their blocks from Notion (with nested blocks recursively)
• getDatabasePages(databaseId) - Query pages from a database
• updatePageUrl(pageId, url) - Update page URL property