Skip to main content
PATCH
Update a dashboard digest

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

If-Match
string | null

The digest's current ETag.

x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

dashboard_id
string
required
digest_id
string
required

Body

application/json

Changes to apply to a digest.

Omitted fields remain unchanged. An explicit null clears a nullable field.

name
string
Required string length: 1 - 255
custom_message
string | null
schedule
DailySchedule · object
delivery_format
enum<string>
Available options:
pdf,
png,
url
state
enum<string>
Available options:
active,
paused
filters
Filters · object[] | null

Filters applied to the dashboard when it is captured, in place of the dashboard's own saved filters. Set this field to null to clear the override, so the digest goes back to capturing with the dashboard's saved filters; set it to an empty array to capture with no filters at all. Each entry names a field, an operator, and the value or values to compare against, and entries are combined with AND; an entry may instead be an and/or group containing its own entries in the same form. The operators available are the ones the dashboard's filter controls offer. A filter naming a field that none of the dashboard's blocks expose has no effect on the capture.

Example:
destination_ids
string[]
Minimum array length: 1

Response

Successful Response

A schedule that captures a dashboard and delivers it to destinations.

id
string
required
read-only

The unique identifier of the digest.

dashboard_id
string
required
read-only

The dashboard this digest captures and delivers.

name
string
required

The display name of the digest.

schedule
DailySchedule · object
required

How often the digest is delivered.

delivery_format
enum<string>
required

The format the dashboard is captured and delivered in.

Available options:
pdf,
png,
url
destination_ids
string[]
required

The destinations the digest delivers to.

destinations
DigestDestination · object[]
required
read-only

The destinations the digest delivers to, with display details.

created_by
string
required
read-only

The identifier of the user or API key that created the digest.

create_time
string
required
read-only

When the digest was created, as an RFC 3339 UTC timestamp.

update_time
string
required
read-only

When the digest was last changed, as an RFC 3339 UTC timestamp.

etag
string
required
read-only

Opaque strong ETag. Supply it in an If-Match header when changing or deleting the digest.

custom_message
string | null

A message included alongside the delivered dashboard.

state
enum<string>
default:active

Whether the digest is actively delivering on its schedule or paused.

Available options:
active,
paused
filters
any[] | null

Filters applied to the dashboard when it is captured, in place of the dashboard's own saved filters. Omit this field or set it to null to capture the dashboard with its saved filters; set it to an empty array to capture the dashboard with no filters at all. Each entry names a field, an operator, and the value or values to compare against, and entries are combined with AND; an entry may instead be an and/or group containing its own entries in the same form. The operators available are the ones the dashboard's filter controls offer. A filter naming a field that none of the dashboard's blocks expose has no effect on the capture.

Example:
latest_run
DigestRun · object | null

The most recent attempt to run this digest, if any.