Skip to main content

API Keys

All API requests require an API key passed in the x-api-key header.
curl -X POST https://api.rhizomeai.com/api/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query_text": "example"}'

Getting an API Key

  1. Log in to Rhizome
  2. Go to API Keys
  3. Click Create API Key
  4. Copy your key immediately — it’s only shown once!
API access requires an enterprise plan. Contact [email protected] to upgrade your account.

Security Best Practices

API keys should only be used in server-side code. Never include them in JavaScript running in the browser.
Store your API key in environment variables, not in source code.
export RHIZOME_API_KEY="your-api-key"
import os
api_key = os.environ["RHIZOME_API_KEY"]
If you suspect your API key has been compromised, delete it immediately from the API Keys console and create a new one.

Error Responses

StatusErrorDescription
401Missing or invalid x-api-key headerNo API key provided
401Invalid API keyThe API key doesn’t exist or was deleted
429Rate limit exceededToo many requests (see Rate Limits)