Queries

Update a query

Updates a saved query. Only the fields you send change; sql and folderPath are optional. Available to API keys with the write scope. Changing the sql or variables of a query that has a schedule also needs the execute scope, since the schedule runs it.

put/queries

Request

  • Base URL: https://saturnsql.com/api
  • URL: https://saturnsql.com/api/queries
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

queryIdstring required
namestring required
sqlstring
folderPathstring nullable

A single flat folder label, not a nested path ("A/B" is one label); null moves to root; omit to leave unchanged

Response

Updated

idstring
namestring
sqlstring
connectionIdstring nullable
folderPathstring nullable

A single flat folder label (not a nested path); "A/B" is one folder named "A/B", not "A" containing "B". null = root.

isSharedboolean
descriptionstring nullable

Subtitle on the report page. Returned by GET /queries; nothing can set it yet, so always null.

userIdstring
createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.