sql is updated, parameters is automatically re-extracted from the new SQL. JSON null is treated as “unchanged” for every field, so this endpoint cannot clear sql or description to null.
string
required
Bearer token obtained from the authenticate endpoint.
string
required
Unique identifier of the saved query to update.
string
New display title for the query.
string
New natural-language formatting instruction. Parameter placeholders in this field are not substituted.
string
New SQL Server statement. Use
{{param_name}} placeholders for values supplied at runtime and quote string-literal placeholders, for example Region = '{{region}}'. Updating this field automatically re-extracts parameters.string
New description for the query.
Response
Returns the updated saved query object.string
required
Unique identifier for the query.
string
required
Organization the query belongs to.
string
required
Updated display title.
string | null
Updated description.
string
required
Updated natural language instruction.
string | null
The current SQL for this query, or
null if none was stored.string[]
required
Re-extracted
{{param_name}} placeholder names from the current sql. Updated automatically whenever sql changes.string
required
Member ID of the user who made this update.
string
Display name of the user who made this update.
string
required
ISO 8601 timestamp when the query was originally created.
string
required
ISO 8601 timestamp of this update.
keywords and display do not update the stored query.