Recordings

All routes on this page require x-api-key.

Generate a recording URL for a job or browser session.

Request fields:

Provide exactly one of job_id or session_id.

Response fields:

recording_url is null when no recording is available for the job or session. Runs created with headless: true are not recorded, and neither are runs that fail before a browser starts. When Libretto returns a URL, treat it as an opaque browser link.

Treat recording_url as temporary and refetch it rather than storing it. recording_url_expires_at is null when the link has no fixed expiry. If a URL stops working, call this route again with the same job_id or session_id to get a fresh one; the recording itself is not regenerated or deleted when a URL expires. Recordings remain available for 30 days after the run. See Data retention.

Example:

12345678curl -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>"
    }
  }'