Skip to main content

API Keys

API keys let you access SuperDocs from your code, scripts, or AI tools.

Create a key

  1. Open use.superdocs.app and sign in
  2. Click the gear icon to open Settings
  3. Go to the API Keys tab
  4. Click Create API Key
  5. Enter a name (e.g., “My App” or “CI/CD”)
  6. Copy the key immediately — it’s only shown once

Key format

Keys start with sk_ followed by 32 hex characters:
sk_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

Authentication

Include your key in the Authorization header:
curl -X POST https://api.superdocs.app/v1/chat \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello", "session_id": "test"}'
The same header format works for both REST API and MCP connections.

Key limits

PlanMax keys
Free5
Plus, Pro, Enterprise25

Security

  • Keys are shown once at creation. Store them securely.
  • Keys are stored as hashed values — we cannot recover a lost key.
  • Revoke a key anytime from Settings > API Keys. Revocation is permanent.
  • Never commit keys to source control. Use environment variables.

Organization keys

Enterprise organizations can also use organization keys (prefixed lce_). These work identically — same Authorization: Bearer header, same endpoints. Organization keys are provisioned for B2B customers.

Manage keys via API

You can also manage keys programmatically:
# Create a key
curl -X POST https://api.superdocs.app/v1/users/me/api-keys \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Production"}'

# List keys
curl https://api.superdocs.app/v1/users/me/api-keys \
  -H "Authorization: Bearer sk_YOUR_API_KEY"

# Revoke a key
curl -X DELETE https://api.superdocs.app/v1/users/me/api-keys/KEY_ID \
  -H "Authorization: Bearer sk_YOUR_API_KEY"