Recordings

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:

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

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.

Recordings

POST /v1/recordings/get

POST `/v1/recordings/get`