Kubiya LogoKubiya Developer Docs

Authentication

Learn how to authenticate with the Kubiya API

Authentication

The Kubiya API uses API keys to authenticate requests. You can view and manage your API keys in the Kubiya dashboard.

This playground makes API calls to Kubiya API through a secure server-side proxy. Your requests never expose your API token directly to the browser.

API Keys

To authenticate your requests, include your API key in the Authorization header:

Authorization: UserKey YOUR_API_KEY

Keep your API keys secure and never share them publicly. Rotate your keys regularly and use different keys for different environments.

Example Usage

# Example request with API key authentication
curl -X GET "https://api.kubiya.ai/api/v1/agents" \
  -H "Authorization: UserKey YOUR_API_KEY" \
  -H "Content-Type: application/json"

Common Errors

HTTP StatusDescription
401Unauthorized - API key is missing or invalid
403Forbidden - The API key doesn't have permission to access the requested resource

Error Response Example

If your API key is invalid or missing, you'll receive a 401 Unauthorized response:

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Next Steps

After authenticating, you can:

  • Manage Users in your organization
  • Set up Agents for your users to interact with
  • Configure Sources to provide tools

On this page