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 Status	Description
401	Unauthorized - API key is missing or invalid
403	Forbidden - 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

Authentication

Authentication

API Keys

Example Usage

Common Errors

Error Response Example

Next Steps

On this page