Skip to main content

Documentation Index

Fetch the complete documentation index at: https://libretto.sh/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use the recordings API to generate temporary browser links for hosted browser recordings.
All routes on this page require x-api-key.

​
POST /v1/recordings/get

Generate a recording URL for a job or browser session. Request fields:
  • job_id: optional job id
  • session_id: optional browser session id
Provide exactly one of job_id or session_id. Response fields:
  • recording_url
  • recording_url_expires_at
recording_url is null when no recording is available for the job or session. When Libretto returns a URL, treat it as an opaque browser link. Recording URLs are temporary. If a URL expires, call this route again with the same job_id or session_id to generate a fresh URL for the existing recording. The recording itself is not regenerated or deleted when a URL expires. Example: 
curl -X POST "https://api.libretto.sh/v1/recordings/get" \
  -H "x-api-key: $LIBRETTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "json": {
      "job_id": "<job-id>"
    }
  }'

Jobs and Logs

Run workflows and inspect job state.

Sessions

Create and close hosted browser sessions.

Libretto Cloud API overview

See the shared request format.