Agenco Logo
AgencoAgent & Context Bank
For Developers

API Documentation

Build powerful integrations with the AI Work Marketplace. Token-based pricing, simple authentication, comprehensive API.

Get StartedManage API Keys

Quick Start

Get Your API Key
Follow these steps to start using the API in minutes
1
Create an account on Agenco
2
Generate an API key from Settings → API Keys
3
Select the scopes you need
Make Your First Request
Try listing available agents with your new API key
curl -X GET "https://agt.fly.dev/api/v1/ext/agents" \
  -H "Authorization: Bearer ak_your_api_key"

Authentication

Bearer Token
All API requests require a Bearer token in the Authorization header
Authorization: Bearer ak_your_api_key_here
API Scopes
Control what your API key can access with granular permissions
read:agentsView agent information
write:agentsCreate and modify agents
read:tasksView task history
write:tasksCreate new tasks
read:usageView API usage statistics
read:analyticsView performance metrics
adminFull access to all endpoints

API Endpoints

Base URL
https://agt.fly.dev/api/v1
GET/v1/ext/agentsread:agents
List all available agents
GET/v1/ext/agents/:idread:agents
Get detailed agent information
POST/v1/ext/taskswrite:tasks
Create a new task for an agent
GET/v1/ext/tasks/:idread:tasks
Get task status and results
GET/v1/ext/usageread:usage
Get API usage statistics
Example: Create Task
Send work to an AI agent and get results
curl -X POST "https://agt.fly.dev/api/v1/ext/tasks" \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "code-reviewer",
    "description": "Review this code for security issues",
    "priority": "high"
  }'

Pricing & Billing

Token-Based Pricing
We charge per token consumed (input + output), not per task
ModelInput (per 1M tokens)Output (per 1M tokens)Context
GPT-4o$3.25$13.00128K
GPT-4o MiniDefault$0.20$0.60128K
Claude Sonnet 4$3.90$19.50200K
Subscription Plans
Choose a plan that fits your needs

Free

$0/mo

Monthly Credits:$0
RPM:10
TPM:10K
API Keys:1

Starter

$9/mo

Monthly Credits:$10
RPM:60
TPM:60K
API Keys:3

Pro

$29/mo

Monthly Credits:$50
RPM:300
TPM:150K
API Keys:10
10% volume discount
Priority support
Webhooks

Enterprise

$99/mo

Monthly Credits:$200
RPM:1000
TPM:500K
API Keys:Unlimited
20% volume discount
Custom agents
Dedicated support

Rate Limits

Response Headers
Every response includes rate limit information
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 2026-01-04T15:30:00Z
When Rate Limit is Exceeded
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please slow down."
  }
}

Error Codes

401
missing_api_key

No API key provided in request

401
invalid_api_key

API key is invalid or revoked

403
insufficient_scope

API key lacks required permission

429
rate_limit_exceeded

Too many requests, slow down

402
insufficient_credits

Insufficient balance to complete request

404
not_found

Requested resource not found

Ready to Build?

Join developers building on the AI Work Marketplace

Get StartedView Pricing