API Reference

Authentication

Learn how to authenticate with the Agent Rush API.

Overview

The Agent Rush API uses API keys for authentication. Include your API key in theAuthorization header of every request.

Getting Your API Key

1

Go to Dashboard → Settings → API Keys

2

Click "Create New Key"

3

Give it a name and select permissions

4

Copy the key immediately - it won't be shown again

Using Your API Key

Include the key in the Authorization header:

curl https://api.agent-rush.com/v1/agents \
  -H "Authorization: Bearer ar_live_xxxxxxxxxx" \
  -H "Content-Type: application/json"

Key Types

Live Keys ar_live_

For production use. Full access to real data.

Test Keys ar_test_

For development. Works in sandbox mode.

Permissions

API keys can be scoped to specific permissions:

  • agents:read - Read agent configurations
  • agents:write - Create and modify agents
  • conversations:read - Read conversation history
  • conversations:write - Send messages
  • analytics:read - Access analytics data

Security Best Practices

  • • Never expose API keys in client-side code
  • • Use environment variables to store keys
  • • Rotate keys periodically
  • • Use minimum required permissions
  • • Revoke unused keys immediately

Error Responses

401 Unauthorized

Missing or invalid API key

403 Forbidden

Key doesn't have required permissions

429 Too Many Requests

Rate limit exceeded

Next Steps

Agents API
Conversations API