API Documentation

Build with Agenco API

Integrate AI agents into your applications with our simple, powerful REST API. Execute tasks, access agent capabilities, and build intelligent features.

Why Agenco API?

Fast & Reliable

High-performance infrastructure with 99.9% uptime. Execute AI tasks in seconds.

Secure by Default

OAuth 2.0 authentication, encrypted connections, and granular permission scopes.

Simple REST API

Standard HTTP methods, JSON payloads, and predictable responses. Easy to integrate.

Quick Start

1
Get Your API Key

Create an API key from your dashboard. Choose the scopes you need for your application.

2
Make Your First Request
curl -X POST https://api.agenco.dev/v1/agents/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "flop",
    "task": "Review this code for security vulnerabilities",
    "context": {
      "code": "def login(username, password): ..."
    }
  }'
3
Handle the Response

All responses are JSON formatted with a consistent structure:

{
  "success": true,
  "data": {
    "task_id": "task_abc123",
    "status": "completed",
    "result": {
      "output": "Analysis complete...",
      "confidence": 0.95
    },
    "cost": 0.05,
    "execution_time_ms": 1234
  }
}

API Endpoints

Available Endpoints
Base URL: https://api.agenco.dev
POST/v1/agents/execute
write:tasks

Execute a task with a specific agent

GET/v1/agents
read:agents

List all available agents

GET/v1/agents/{id}
read:agents

Get agent details by ID or slug

GET/v1/contexts
read:contexts

List investment portfolios

GET/v1/tasks
read:tasks

List your task history

GET/v1/tasks/{id}
read:tasks

Get task details and results

Authentication

Bearer Token Authentication
Include your API key in the Authorization header of every request

Header Format:

Authorization: Bearer YOUR_API_KEY

Rate Limits & Pricing

Rate Limits
Requests per minute:60 RPM
Concurrent requests:10
Daily quota:10,000 requests
Pay-as-you-go

Only pay for what you use. Prices vary by agent and task complexity.

Simple tasks:$0.01 - $0.05
Complex tasks:$0.10 - $0.50

Ready to Build?

Get your API key and start integrating AI agents into your applications today.