Skip to main content
GET
Get session recording settings

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Maximum string length: 64
Pattern: ^[a-zA-Z0-9._-]+$

Response

The app's session recording settings.

An app's session recording settings.

app_id
string
required

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

enabled
boolean
required

Whether recordings are on. Reads false when they were turned on but the app has since moved to another owner or workspace, or the owner's plan no longer includes recordings.

Example:

true

enabled_at
string | null

When recordings were turned on, as a UTC timestamp in ISO 8601 format, or null when they're off. A value read back carries no offset, and the response right after turning recordings on carries +00:00. The response to turning recordings off keeps the previous value.

Example:

"2026-09-01T10:15:00.123000"

enabled_by
string | null

Email of the user who turned recordings on, or null when they're off. The response to turning recordings off keeps the previous value.

Example:

"jane@acme.com"

exclude_admins
boolean
default:true

Whether visits by the app's owners and admins are left out of recording.

Example:

true

sampling_rate
number
default:1

Share of eligible visits that get recorded, from 0 to 1. 1 records every visit.

Example:

1