Skip to main content

​
API Keys

API keys let you interact with the Ringyo AI API programmatically. Available on Pro and Agency plans.

​
Generating an API Key

1

Go to Developers

Navigate to Dashboard → Developers → API Keys.
2

Create a new key

Click Create API Key and provide:
  • Name — a descriptive label (e.g., “Production Server”, “Staging”)
  • Permissions — choose which resources the key can access
3

Copy your key

Your API key will be displayed once. Copy and store it securely.
The full API key is only shown at creation. If you lose it, you’ll need to create a new one.

​
Key Format

API keys follow this format:
  • rg_live_ — production keys that make real calls and consume credits
  • rg_test_ — test keys for development (no real calls, no credit usage)

​
Using Your API Key

Include the key in the Authorization header:
See the API Reference for full documentation.

​
Permissions

When creating a key, you can scope it to specific resources:
Follow the principle of least privilege. Only grant permissions each key actually needs.

​
Managing Keys

From Dashboard → Developers → API Keys, you can:
  • View — see all active keys with last used timestamps
  • Rename — update the key name or description
  • Revoke — permanently disable a key (cannot be undone)
  • Regenerate — create a new key and disable the old one

​
Rate Limits

Exceeding the limit returns 429 Too Many Requests. Implement exponential backoff in your integration.

​
Security Best Practices

  • Never expose keys in client-side code — only use them server-side
  • Use environment variables — don’t hardcode keys in source code
  • Rotate regularly — regenerate keys periodically
  • Use test keys for development — avoid spending credits during testing
If you suspect a key has been compromised, revoke it immediately from the dashboard.

​
Next Steps