User Guide/Reference

Reference

How to Create a Cortex API Key

Create and manage Cortex API keys for scripts, coding agents, and other non-browser callers.

When You Need An API Key

You only need a Cortex API key when a script, coding agent, CI job, or other non-browser caller needs to access the Cortex API directly.

You do not need an API key for normal in-browser usage of the Cortex application.

Who Can Create API Keys

Cortex API keys are managed at the organization level. Only organization admins can create or revoke them.

How To Create One

1. Create or sign in to your Cortex account.
2. Switch into the organization where the key should live.
3. Open Settings → Credentials.
4. Find Cortex API Credentials and click Create API Key.
5. Enter a descriptive credential name, such as solana-validator-guide-agent.
6. Choose the minimum role the key needs.
7. Click Create API Key.
8. Copy the secret immediately and store it somewhere secure.

Which Role To Choose

Choose the smallest role that still allows the caller to do its job.

• Org Admin — use this when the agent or script needs to create, update, or manage Cortex objects.
• Org Member — use this when the caller only needs read-oriented API access.

How To Use The Key

Send the API key as a bearer token in the HTTP Authorization header.

Authorization: Bearer YOUR_CORTEX_API_KEY

Use the API reference for endpoint-level request and response details.

Handle Secrets Carefully

Cortex only shows the API key secret once, immediately after creation. If you lose it, create a new key and revoke the old one.