Skip to main content
Every request to the Graphy Agents API is authenticated with an API key. You create and manage keys in the Graphy console, then send the key as a Bearer token on each request.

​
Get your API key

  1. Go to the Graphy console.
  2. Sign in with Google or GitHub.
  3. Open the API keys section.
  4. Click Create key, give it a name (for example production), and confirm.
  5. Copy the key right away — it’s shown only once and cannot be retrieved later. Store it in a secrets manager or an environment variable.
Keys look like graphy_…. You can keep up to 5 active keys at a time — create separate keys for development and production, and revoke any you no longer use from the same page in the console.

​
Use your key

Send the key in the Authorization header as a Bearer token on every request: 
Authorization: Bearer graphy_xxxxxxxxxxxxxxxxxxxxxxxx
With the TypeScript SDK, pass it as apiKey: 
import { GraphyAiSdk } from '@graphysdk/agents-sdk';

const ai = new GraphyAiSdk({
  apiKey: process.env.GRAPHY_API_KEY, // your graphy_… key
  baseUrl: 'https://agents.graphy.dev',
});
See Authentication for the full header reference and authentication error codes.

​
Keep your keys safe

Never expose API keys in client-side code. Call the Agents API from your backend only.
  • Store keys in environment variables or a secrets manager.
  • Use separate keys for development and production.
  • Rotate keys periodically and revoke unused ones in the console.

​
Next steps

Quickstart

Generate your first chart in 5 minutes

Authentication

Headers, base URL, and error codes