Get a screenshot at a timestamp
Extracts a still frame of the recording at the given timestamp and returns a presigned URL to the image. If is_screenshot_ready is false, the recording’s downloadable video is not up to date yet — call POST /recordings/{id}/trigger-mp4 to regenerate it, then retry.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
API key. Refer to Authentication for more information.
Must be application/json.
application/json Path Parameters
The recording's id (UUID) or its public_link_id (the short code in the watch URL). Both are accepted.
Query Parameters
Timestamp in seconds (may be fractional) of the frame to capture.
x >= 0Image format: png or jpeg. Defaults to png.
png, jpeg Response
Screenshot URL generated, or not ready yet.
png, jpeg false when the recording's video file is outdated. Call POST /recordings/{id}/trigger-mp4 to regenerate it, then retry.
Presigned URL to the image. Omitted entirely when is_screenshot_ready is false.
Lifetime of the presigned URL. Omitted entirely when is_screenshot_ready is false.