Developer API

AgentDesk API

Programmatic access to your entire agent fleet.

Terminal

curl -X POST https://api.myagentdesk.ai/v1/agents/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "sales-agent",
    "input": {
      "lead_email": "user@company.com"
    }
  }'

Response200 OK

{
  "task_id": "tsk_01HXYZ8K2P",
  "agent": "sales-agent",
  "status": "queued",
  "created_at": "2025-07-01T09:42:00Z",
  "estimated_completion_ms": 1800
}

What You Can Do via API

Full programmatic control over every agent, task, and configuration in your account.

Trigger agent tasks programmatically

Fire any agent task via a single API call — from your backend, your CRM, or any automation platform.

Read task results and status

Poll or receive callbacks with full task output, status codes, and metadata.

Manage agent configurations

Update agent instructions, personas, and workflow rules without touching the UI.

Access task history and audit logs

Retrieve complete logs of every agent action for compliance, QA, or analytics.

Set up webhook callbacks

Monitor usage and costs

Query usage metrics, task counts, and cost data to build internal dashboards or billing integrations.

Use Cases for the API

The API is built for developers who want to extend AgentDesk beyond the dashboard.

Embed agents in your own product

Build AgentDesk capabilities directly into your SaaS product or internal tool. Your branding, your UX, our agents.

Trigger agents from your CRM or ERP

Connect HubSpot, Salesforce, or SAP workflows to automatically invoke agents when deals, tickets, or records change state.

Build custom dashboards on top of agent data

Pull task results, performance metrics, and usage data into your existing BI stack.

Automate agent management across environments

Use the API to deploy, configure, and roll back agent changes across staging and production environments programmatically.

Getting Started

Request API access

Submit a request from your AgentDesk dashboard or via the form below. API access is available on Growth and Enterprise plans.

Get your API key

Once approved, generate your API key from the Settings > API section of your dashboard. Keys are scoped by agent and permission level.

Read the docs

Full API reference, SDK quickstarts, and code examples are available in the developer documentation at docs.myagentdesk.ai.

Ready to build with the API?

API access is available on Growth and Enterprise plans. Request access from your dashboard or start with a free account and upgrade when ready.

Request API Access Read the Docs