Skip to main content

API Keys Overview

API keys let you authenticate with Wren AI. There are two scopes:

Key TypeScopeTypical Use Cases
OrganizationOrg-wide across all projectsProvisioning projects, automation, admin scripts
ProjectSingle project onlyApp integrations, scoped access for one project

Choose the right key

  • Use an organization key for cross-project tasks, provisioning, and administration
  • Use a project key for least-privilege access in a single application or service

Create and manage

Best practices

  • Create separate keys per environment (dev/staging/prod)
  • Store keys securely (secrets manager, vault). Never commit to source control
  • Monitor usage in API History