API Reference

Use the Agent Leap API to manage agents and tasks from your own applications. This is a simple REST API with JSON responses.

Note: API access is available on the Business plan (€149/mo). Upgrade from your dashboard to get your API key.

Authentication

All API requests require an API key sent in the Authorization header. You can find your API key in your dashboard under Settings > API.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.agentleap.fi/v1/agents

Base URL

https://api.agentleap.fi/v1

Endpoints

POST/v1/agents

Create a new AI agent. Provide a name and a description of what the agent should do.

curl -X POST https://api.agentleap.fi/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d {
    "name": "Email Summarizer",
    "description": "Summarize incoming emails every morning at 9:00"
  }
GET/v1/agents

List all your agents. Returns an array of agent objects with their current status.

curl https://api.agentleap.fi/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/v1/tasks

Manually trigger a task for a specific agent. Useful for one-off runs or testing.

curl -X POST https://api.agentleap.fi/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d {
    "agent_id": "ag_abc123",
    "input": "Summarize todays emails"
  }'
GET/v1/tasks

List recent tasks across all agents. Filter by agent_id, status, or date range.

curl "https://api.agentleap.fi/v1/tasks?agent_id=ag_abc123&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate limits

API requests are limited to 100 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response. The response headers include X-RateLimit-Remaining and X-RateLimit-Reset to help you manage your request rate.