Services

External API integrations (pure API calls only).

Responsibilities

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

Examples

  • getDatabaseById(id) - Get a specific database
  • searchNotionDatabases() - Search for databases