Skip to main content

​
Overview

The Headless Agents API allows you to interact with AI agents programmatically. This API provides endpoints for health checking, calling agents, and retrieving agent statistics.

​
Authentication

All API requests (except /health) require authentication using your Headless Agents API key provided as an X-API-Key header. Example: 
curl -H "X-API-Key: your_api_key" https://api.headlessagents.ai/call/your_agent_id

​
Available Endpoints

Health Check

Check if the API is up and running

Call Agent

Send requests to an agent and get responses

Agent Statistics

Get usage statistics for your agents

​
Base URL

All API requests should be made to: 
https://api.headlessagents.ai