Skip to main content

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 NameDescription
paramsAn object containing key-value pairs to pass into the query, accessed with this.params.key
onSuccessThe function to be executed when the run method succeeds
onErrorThe 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.{ 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 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

{{ }}

The data type of this property depends on the data.