Query Object


Each query object contains a run function used to execute the query. The run function is asynchronous by nature and can be chained using the callbacks in the function signature.


You can now use JavaScript Promises (recommended).
run(params: Object): Promise
If you want to use Callbacks (not recommended), copy the signature below:
run(onSuccess: Function, onError: Function, params: Object): void
where onSuccess and onError are functions and params is a dictionary of key-value pairs.
We suggest you use the JavaScript Promise signature as it makes the code easy and readable. Callbacks are an old way and will be deprecated soon.
We recommend using the following Promise syntax:
.then(() => {...}) // run after the query is successful
.catch(() => {...}) // run if the query encounters any errors


Argument Name
An object containing key-value pairs to pass into the query, accessed with this.params.key
The function to be executed when the run method succeeds
The function to be executed when the run method fails

Passing Params to Run

Most Queries read values directly from entities as global variables. In some cases, like running a query inside a loop, parameters may need to be passed to the query with values contextual to the execution. It can be achieved using the params argument of the run signature. Please see the example below.
UsersApi.run({ org: "Appsmith" })
.then((response) => showAlert(response) )
.catch((error) => showAlert(error, 'error'))
Params sent to a query can be accessed using the this keyword
{{ this.params.key }}
Please see the quick demo below showing how to access your params from Query.run(params) within the query. We'll use the Postman Echo API, which will echo our request. We'll pass it { phrase: "hello, world!" } , and then receive it back as a response:
Use {{this.params.key}} within your query to access any params you passed within the .run(params) function.


The onSuccess function is run when a query runs successfully. The function returns the response of the query and the params passed to it in the callback arguments.
onSuccess(response, params): void


The onError function is run when a query execution fails. The function returns the response of the query and the params passed to it.
onError(response, params): void


Each query stores the data from its latest run inside its data property. This property is populated only if the query successfully executes and can be accessed as
{{ Query1.data }}
The data type of this property depends on the data.
Copy link
Edit on GitHub
On this page
Passing Params to Run