Projects

Projects are the top-level containers for your AI integration. They map one-to-one with your applications (e.g., "Customer Support Bot", "Marketing Copy Generator"). Each project has its own API keys, security policies, rate limits, and usage analytics. This allows you to keep different applications or environments completely separate.

• Isolation: Each project has its own API keys and configuration
• Organization: Group related AI features into a single project
• Analytics: Track usage and costs per project
• Collaboration: Everyone in the organization can work in its projects

1. Click the project name at the top of the sidebar.
2. Click Create project.
3. Enter a name, an optional description, and pick a region.

For a typical CI/CD workflow, we recommend this project structure:

1. my-app-dev: Connect to your localhost or staging environment. Use Publishable Keys with localhost:3000 allowed.
2. my-app-prod: Connect to your production deployment. Use strict Allowed Domains and stricter Spend Caps.

Test vs Production Keys

• Production keys (csk_...) - use these in live applications.
• Test keys (csk_test_...) - use these during development. Test keys have lower rate limits and don't incur charges.

Environment Configuration

# .env.development
CENCORI_API_KEY=csk_test_...

# .env.production
CENCORI_API_KEY=csk_...

Each project has its own settings: name and request handling, budget and spend cap, providers and failover, networking, integrations, API keys and webhooks. See Project settings for every tab.

Invite team members to your organization to grant them access to all projects within it.

1. Open Organization settings (from the user menu) and go to Teams.
2. Click Invite member.
3. Enter email and assign role:

Inviting team members requires a paid plan (Pro, Team, or Enterprise).

API keys authenticate your application with Cencori. Each project can have multiple API keys for different purposes.

Generating API Keys

1. Open the project's Settings → API tab.
2. Click New secret key (for your server) or New publishable key (for browser code, limited to the domains you list).
3. Give your key a descriptive name (e.g., "Production Web Server").
4. Copy the key immediately - it won't be shown again.

Key Rotation

For enhanced security, rotate your API keys regularly:

1. Generate a new API key in the dashboard.
2. Update your application to use the new key.
3. Deploy the changes.
4. Verify the new key is working.
5. Revoke the old key.

If you no longer need a project, you can delete it from the project settings.