Skip to main content

API Keys

API keys authenticate your requests to the CTWise API. This guide covers how to generate, manage, and secure your API keys.

Overview​

Each API key:

  • Is unique to your account
  • Should be kept secret
  • Can be revoked at any time
  • Starts with the prefix ctw_

Generating an API Key​

Step 1: Navigate to API Keys​

  1. Log in to your dashboard
  2. Select CTWise from the product selector
  3. Click API Keys in the navigation menu

API Keys Page

Step 2: Create New Key​

  1. Click Generate New Key
  2. Enter a description for the key (e.g., "Production Server", "Development")
  3. Click Generate

Step 3: Copy Your Key​

Important: Your API key is only shown once. Copy it immediately and store it securely.

  1. Click the Copy button next to the key
  2. Store the key in a secure location (e.g., environment variables, secrets manager)
  3. Click Done

Example API key format:

ctw_a5f1b866f29b2b74f6b61ccc777b59a3

Using Your API Key​

Include your API key in the x-api-key header with every request:

curl -X POST "https://api.ctwise.ai/v1/search" \
  -H "x-api-key: ctw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "FDA clinical trial requirements"}'

Python Example​

import requests

headers = {
    "x-api-key": "ctw_YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.ctwise.ai/v1/search",
    headers=headers,
    json={"query": "FDA clinical trial requirements"}
)

JavaScript Example​

const response = await fetch("https://api.ctwise.ai/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": "ctw_YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ query: "FDA clinical trial requirements" })
});

Viewing Your Keys​

The API Keys page shows all your active keys:

ColumnDescription
Key IDFirst 8 characters of the key (for identification)
DescriptionYour description for the key
CreatedWhen the key was generated
Last UsedLast time the key was used (if tracked)
ActionsRevoke button

Note: The full key is never shown after creation for security reasons.

Revoking an API Key​

To revoke a key that's no longer needed or may have been compromised:

  1. Navigate to API Keys
  2. Find the key you want to revoke
  3. Click the Revoke button
  4. Confirm by clicking Yes, Revoke

Warning: Revoking a key is immediate and permanent. Any applications using that key will stop working.

Key Limits​

TierMax Active Keys
Free2
Starter5
Pro10
Enterprise25

Security Best Practices​

Do​

  • Store keys in environment variables or a secrets manager
  • Use different keys for development and production
  • Rotate keys periodically (every 90 days recommended)
  • Revoke unused keys immediately

Don't​

  • Commit keys to version control (Git, etc.)
  • Share keys in plain text (email, chat, etc.)
  • Embed keys in client-side code (JavaScript in browsers)
  • Use the same key across multiple environments

Environment Variables Example​

# Set the environment variable
export CTWISE_API_KEY="ctw_YOUR_API_KEY"

# Use in your application
import os
api_key = os.environ.get("CTWISE_API_KEY")

Troubleshooting​

"Invalid API Key" Error​

If you receive a 401 error with "Invalid API key":

  1. Verify the key is copied correctly (no extra spaces)
  2. Check the key hasn't been revoked
  3. Ensure you're using the correct header name (x-api-key)

"Rate Limit Exceeded" Error​

If you receive a 429 error:

  1. Check your tier's rate limit
  2. Implement exponential backoff in your code
  3. Consider upgrading your tier if you need higher limits

Key Not Working After Generation​

  1. Wait a few seconds - keys activate immediately but propagation may take a moment
  2. Verify you copied the full key
  3. Try generating a new key if the issue persists

Next Steps​