API Reference
Complete REST API reference for the Loop autonomous improvement engine. Manage issues, signals, templates, dispatch, and more.
API Reference
The Loop API is a REST API that exposes every capability of the engine — ingesting signals, managing issues, dispatching work to agents, and monitoring system health.
Base URL
| Environment | URL |
|---|---|
| Production | https://api.looped.me |
| Local development | http://localhost:4242 |
Authentication
All /api/* endpoints require a Bearer token in the Authorization header:
curl -H "Authorization: Bearer <LOOP_API_KEY>" \
https://api.looped.me/api/issuesWebhook endpoints (/api/signals/github, /api/signals/sentry, /api/signals/posthog) use provider-specific signature verification instead of Bearer tokens.
Full authentication guide
See Authentication for setup instructions, webhook signature verification, and key rotation.
Response Format
List endpoints return paginated results:
{
"data": [{ "id": "...", "...": "..." }],
"total": 42
}Single-item endpoints return the resource directly:
{
"data": { "id": "...", "...": "..." }
}Pagination
List endpoints accept page and limit query parameters:
| Parameter | Default | Description |
|---|---|---|
page | 1 | Page number (1-indexed) |
limit | 20 | Items per page |
Error Format
Errors return a standard shape with an appropriate HTTP status code:
{
"error": "Human-readable error message"
}Common status codes: 400 validation error, 401 missing or invalid token, 404 resource not found, 500 internal error.
Endpoints
Issues
Create, list, update, and delete issues. Filter by status, type, or project. Manage comments and relations.
Projects
Organize issues into projects. Each project tracks an optional goal and aggregates issue counts.
Goals
Define measurable goals with target values and deadlines. Link goals to projects to track progress.
Labels
Create and manage labels for categorizing issues across projects.
Signals
Ingest signals via the generic endpoint or through provider-specific webhooks for GitHub, Sentry, and PostHog.
Templates
Manage prompt templates with full version history. Create versions, promote to active, and review quality.
Prompt Reviews
Submit agent reviews of prompt quality. Reviews feed into EWMA scoring to track template health over time.
Dispatch
Preview the priority queue or atomically claim the next unblocked issue with a hydrated prompt.
Dashboard
System health stats, activity timeline with signal chains, and prompt health metrics.
System
Health check and service info endpoints. No authentication required.