API Reference

https://api.convosphere.site/api

Authorization: Bearer conv_YOUR_API_KEY

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000

{
  "error": "Error code",
  "message": "Human-readable error message"
}

npm install @convosphere/ai-sdk

import { ConvosphereClient } from '@convosphere/ai-sdk';

const client = new ConvosphereClient({
  apiKey: 'conv_YOUR_API_KEY'
});

const response = await client.agents.chat('agent_123', {
  message: 'Hello',
  stream: false
});

pip install convosphere-ai

from convosphere import ConvosphereClient

client = ConvosphereClient(api_key='conv_YOUR_API_KEY')

response = client.agents.chat('agent_123', {
    'message': 'Hello',
    'stream': False
})

# Get your API key from the dashboard
export CONVOSPHERE_API_KEY="conv_YOUR_API_KEY"

# List your agents
curl -H "Authorization: Bearer $CONVOSPHERE_API_KEY" \
  https://api.convosphere.site/api/agents

# Send a message
curl -X POST \
  -H "Authorization: Bearer $CONVOSPHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello", "stream": false}' \
  https://api.convosphere.site/api/agents/agent_123/chat