Developer API
Trigger AI agents with a single API call
One POST to launch an autonomous AI agent that browses websites, runs code, processes data, sends emails, writes to Sheets — and delivers structured JSON results via webhook or polling.
REST API
HMAC-SHA256
Webhook delivery
60 req/min
curl -- trigger an agent
Request
curl -X POST https://api-v2.autonoly.com/api/v1/agent/trigger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Go to example.com and extract all pricing data",
"callbackUrl": "https://yourapp.com/webhook",
"callbackSecret": "your_secret"
}'Response (202 Accepted)
{
"executionId": "69bbae1f-a4c2-4e8b-9f1d-3c7e8a2b5d90",
"status": "active",
"availableCredits": 10000
}How it works
Three steps. No infrastructure to manage.
1
Send a prompt
POST a natural-language task to the trigger endpoint. Add a webhook URL to get results delivered automatically.
curl -X POST \
https://api-v2.autonoly.com/api/v1/agent/trigger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Find top 5 AI startups on Crunchbase",
"callbackUrl": "https://yourapp.com/webhook"
}'2
Agent executes
An autonomous AI agent figures out the plan — browses sites, runs code, processes data, calls APIs, writes to Sheets — whatever the task needs.
[agent] Analyzing task requirements...
[agent] Launching browser session
[agent] Navigating to crunchbase.com
[agent] Extracting structured data (5 rows)
[agent] Processing results with Python
[agent] Exporting to Google Sheets
[agent] Task complete. Delivering results.3
Get structured results
Receive typed JSON at your webhook, or poll the result endpoint. Every output is labeled and ready to use in your app.
{
"executionId": "69bbae1f...",
"status": "completed",
"presentedResult": {
"summary": "Found 5 AI startups..."
},
"outputs": [
{ "nodeType": "EXTRACT_DATA", "label": "Startup data" }
],
"creditsConsumed": 12
}Works with any language
Trigger agents from cURL, Python, Node.js, Go, or any language with an HTTP client.
curl
curl -X POST https://api-v2.autonoly.com/api/v1/agent/trigger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Go to linkedin.com/company/openai and extract employee count, headquarters, and latest posts",
"callbackUrl": "https://yourapp.com/hooks/autonoly",
"callbackSecret": "whsec_your_hmac_secret"
}'What you can build
Embed autonomous AI agents into any product or workflow.
Telegram / Slack bots
Users send a message, an agent runs the task, and results are delivered back to the chat. Works with any messaging platform.
"Monitor competitor pricing and alert the team"
Scheduled tasks
Cron triggers an agent on a schedule to monitor prices, pull data from APIs, generate reports, or sync records across platforms.
"Every morning, check inventory levels on 3 supplier sites"
Your app's backend
Embed AI-powered web interactions directly into your product. Trigger from any language and get structured JSON responses.
"Extract company info from this LinkedIn profile URL"
Endpoints
Everything you need. Nothing you don't.
Base URL
https://api-v2.autonoly.com
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/agent/trigger | Trigger a new headless agent session |
GET | /api/v1/agent/trigger/list | List recent executions with optional status filter |
GET | /api/v1/agent/trigger/:id/status | Poll execution status and progress |
GET | /api/v1/agent/trigger/:id/result | Get full output data of a completed execution |
POST | /api/v1/agent/trigger/:id/message | Send a follow-up message to an active session |
POST | /api/v1/agent/trigger/:id/stop | Stop a running execution |
GET | /api/v1/agent/credits | Check available credit balance |
Frequently asked questions
Common questions about the Autonoly Developer API.
What is the Autonoly API?
How does authentication work?
How do webhooks work?
What can the AI agent do?
How much does it cost?
What programming languages are supported?
Start building
Get your API key and trigger your first autonomous agent in under a minute. No infrastructure to deploy. No scripts to maintain.