Skip to main content
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.