Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Libretto Cloud API

Use the Libretto Cloud HTTP API to create accounts, manage deployments, run workflows, and inspect results.
The Libretto Cloud API base URL is https://api.libretto.sh.

Request format

All documented Libretto Cloud API routes in this section are POST requests.
Authenticated routes use:
  • x-api-key: <api-key>
  • Content-Type: application/json
  • a JSON body shaped like { "json": { ... } }
For example:
curl -X POST "https://api.libretto.sh/v1/jobs/get" \ -H "x-api-key: $LIBRETTO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "json": { "id": "<job-id>" } }'

Authentication rules

  • POST /v1/auth/* routes are public and do not require x-api-key.
  • All other POST /v1/* routes require x-api-key.
  • The API key must belong to a verified user account.
Use the Libretto Cloud authentication page to sign up, log in, invite users, and issue API keys.