Skip to main content

Authentication

All Kanva API requests require authentication using an API key.

Getting Your API Key​

  1. Log in to the Kanva platform
  2. Navigate to your project settings
  3. Go to the API Keys section
  4. Click Create API Key
  5. Copy and securely store your key
warning

API keys grant full access to your project. Never share them publicly or commit them to version control.

Using Your API Key​

Include your API key in the X-API-Key header of every request:

curl -X POST "https://kanva.human-driven.ai/api/v1/projects/{projectId}/predict" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": {"feature": ["value"]}}'

Security Best Practices​

  • Environment Variables: Store API keys in environment variables, not in code
  • Key Rotation: Periodically rotate your API keys
  • Least Privilege: Create separate keys for different applications if needed
  • Revocation: Immediately revoke compromised keys in the Kanva dashboard

Rate Limits​

API keys are subject to rate limiting. See Rate Limits for details.