> ## Documentation Index
> Fetch the complete documentation index at: https://headlessagents.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the Headless Agents API documentation

## 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:

```bash
curl -H "X-API-Key: your_api_key" https://api.headlessagents.ai/call/your_agent_id
```

## Available Endpoints

<Card title="Health Check" icon="heart-pulse" href="/api-reference/endpoint/health">
  Check if the API is up and running
</Card>

<Card title="Call Agent" icon="message-bot" href="/api-reference/endpoint/call">
  Send requests to an agent and get responses
</Card>

<Card title="Agent Statistics" icon="chart-mixed" href="/api-reference/endpoint/stats">
  Get usage statistics for your agents
</Card>

## Base URL

All API requests should be made to:

```bash
https://api.headlessagents.ai
```