Skip to main content
POST
Preview a report widget

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <credential> using either a Clerk session JWT or a Clerk API key (ak_*). API keys may identify a user (user_*) or organization (org_*) principal and are generated in the Clerk Dashboard under API keys.

Body

application/json
widget
object
required

One report widget. The type field selects the shape: TOP_FLOP | GRAPH_SNAPSHOT | DASHBOARD_PDF | DIGEST | TEXT. All fields other than type depend on the chosen type.

context
object

Response

Widget preview result

type
enum<string>
required
Available options:
TOP_FLOP,
GRAPH_SNAPSHOT,
DASHBOARD_PDF,
DIGEST,
TEXT
status
enum<string>
required
Available options:
PENDING,
SUCCESS,
FAILED
resolvedParameters
object
required

One report widget. The type field selects the shape: TOP_FLOP | GRAPH_SNAPSHOT | DASHBOARD_PDF | DIGEST | TEXT. All fields other than type depend on the chosen type.

result
errorMessage
string | null
Last modified on July 20, 2026