API Reference

Build custom integrations and automate workflows programmatically with the ALLROUNDERAI API.

Getting Started

Base URL

https://api.allrounderai.com/v1

Authentication

All API requests require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

  • • Basic: 100 requests/minute
  • • Pro: 1,000 requests/minute
  • • Enterprise: Custom limits

Core Endpoints

🤖 Agents

GET/agents

List all agents

POST/agents

Create a new agent

GET/agents/:id

Get agent details

PUT/agents/:id

Update an agent

DELETE/agents/:id

Delete an agent

⚡ Executions

GET/executions

List all executions with filters

POST/agents/:id/execute

Trigger agent execution

GET/executions/:id

Get execution details and logs

POST/executions/:id/retry

Retry a failed execution

🔌 Integrations

GET/integrations

List available integrations

GET/integrations/connected

List user's connected integrations

POST/integrations/:name/connect

Connect an integration (OAuth)

DELETE/integrations/:name/disconnect

Disconnect an integration

Code Examples

Create and Execute an Agent

// Node.js / JavaScript
const response = await fetch('https://api.allrounderai.com/v1/agents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Lead Qualifier',
    type: 'sales',
    workflow: {
      trigger: 'webhook',
      actions: [
        { type: 'enrich_contact', integration: 'clearbit' },
        { type: 'score_lead', criteria: { company_size: '>50' } },
        { type: 'create_deal', integration: 'salesforce' }
      ]
    }
  })
});

const agent = await response.json();
console.log('Agent created:', agent.id);

Execute Agent with Input Data

// Python
import requests

response = requests.post(
    'https://api.allrounderai.com/v1/agents/agent_123/execute',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'input': {
            'email': 'john@example.com',
            'company': 'Acme Corp'
        }
    }
)

execution = response.json()
print(f"Execution started: {execution['id']}")

Monitor Execution Status

// cURL
curl -X GET \
  https://api.allrounderai.com/v1/executions/exec_456 \
  -H 'Authorization: Bearer YOUR_API_KEY'

# Response
{
  "id": "exec_456",
  "agent_id": "agent_123",
  "status": "success",
  "started_at": "2026-01-13T10:00:00Z",
  "completed_at": "2026-01-13T10:00:15Z",
  "output": {
    "lead_score": 85,
    "salesforce_deal_id": "deal_789"
  }
}

Webhooks

Subscribe to webhook events to receive real-time notifications when agents execute, fail, or require approval.

Available Events

agent.created
agent.updated
execution.started
execution.completed
execution.failed
approval.requested

Example Webhook Payload

{
  "event": "execution.completed",
  "timestamp": "2026-01-13T10:00:15Z",
  "data": {
    "execution_id": "exec_456",
    "agent_id": "agent_123",
    "status": "success",
    "output": { ... }
  }
}

Official SDKs

📦

JavaScript

npm install @allrounderai/sdk
🐍

Python

pip install allrounderai
🔵

Go

go get github.com/allrounderai/sdk-go

Ready to Build?

Get your API key and start automating workflows programmatically.