API Reference

Complete reference for the AgentHeap REST API.

Base URL
https://api.agentheap.dev
Authentication
All API requests require authentication using Bearer tokens.
Authorization: Bearer YOUR_API_KEY

Join the whitelist to receive your API key.

Endpoints

GET
/v1/agents
Auth Required

List all available agents

GET
/v1/agents/{id}
Auth Required

Get agent details by ID

POST
/v1/agents/{id}/execute
Auth Required

Execute an agent with given input

GET
/v1/executions
Auth Required

List execution history

GET
/v1/executions/{id}
Auth Required

Get execution details and results

POST
/v1/deployments
Auth Required

Create a new agent deployment

Ready to integrate?

Get your API key by joining our whitelist program.

Apply for Access