Skip to main content
UseAgents uses API keys to authenticate protected API requests. Include the key in the Authorization header as a Bearer token.
During the public beta, the UseAgents API is free and does not require authentication. The information below applies when authentication is re-enabled after the beta. Requests are subject to rate limits.
You can view and manage API keys in the UseAgents Dashboard under Settings → API Keys.

​
Protected endpoints

Protected API endpoints require authentication. The /tools/search endpoint is one example.

​
How to authenticate

Include this header in authenticated API requests:
Replace YOUR_API_KEY with the key from your dashboard.

​
Example request

​
Authentication errors

When authentication fails, the API returns specific error responses to help you troubleshoot.

​
Missing API key

If you do not include the Authorization header on a protected endpoint, the API returns 401 Unauthorized:

​
Invalid API key

If the key is incorrect, malformed, revoked, or otherwise invalid, the API returns 403 Forbidden:

​
Best practices

  • Store API keys securely and never commit them to version control.
  • Rotate keys if you suspect they were exposed.
  • Use separate keys for different environments or integrations when appropriate.

​
Next steps

  • Errors to understand other failure responses