Skip to main content
POST
Run a saved query now (a SQL warehouse or Pendo)

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

key
string
required

The integration key, such as snowflake or salesforce

Body

application/json
query_id
string
required

The saved query to run now

end_date
string | null

product_usage only: backfill to this day (YYYY-MM-DD)

start_date
string | null

product_usage only: backfill from this day (YYYY-MM-DD), with end_date

Response

Successful Response

message
string
required
run_id
integer
required

The new run, or the one already in flight

started_at
string<date-time>
required
status
enum<string>
required

scheduled (202): the run starts now; already_running (200): a run of this subtype is in flight

Available options:
scheduled,
already_running