API Contract

LoopCLI exposes a REST API so you can manage projects, loops, and executions from your own services. All endpoints require a Bearer token generated via loopcli auth login.

Base URL

https://app.loopcli.com/api

Override with LOOPCLI_API_URL for staging.

Authentication

POST /auth/token
DELETE /auth/token
GET   /auth/me

Tokens are short-lived JWTs tied to a workspace and user.

Projects

GET    /projects
POST   /projects
GET    /projects/{projectId}
PATCH  /projects/{projectId}
DELETE /projects/{projectId}

Projects group loop definitions and execution history.

Loops

GET    /projects/{projectId}/loops
POST   /projects/{projectId}/loops
GET    /projects/{projectId}/loops/{loopId}
PATCH  /projects/{projectId}/loops/{loopId}
DELETE /projects/{projectId}/loops/{loopId}
POST   /projects/{projectId}/loops/{loopId}/deploy

Deploying locks the current definition for cloud execution.

Executions

POST /projects/{projectId}/loops/{loopId}/run
GET  /projects/{projectId}/executions
GET  /projects/{projectId}/executions/{executionId}

Executions track status (queued, running, success, error), action counts, and per-step metadata.

Webhooks & Worker Endpoint

POST /api/internal/runner/process

Call this endpoint from your cron provider with the RUNNER_WORKER_SECRET to process queued executions.

For the full schema and response examples, see the CLI command reference or the dashboard API explorer.