Queries and mutations

Task runs that are started by Airplane Views can be divided into two categories: queries and mutations. For more information on how to call task queries and mutations, take a look at the documentation about manually executing tasks in views.


A query is a task run that queries for data. Queries are executed behind the scenes by most Airplane components that rely on a task for data, such as the Table component or the Select component.
Queries have intelligent behavior such as caching and automatically refetching data. As a best practice, ensure that tasks that are run as queries are lightweight and read-only as they may be run repeatedly.


A mutation is a task run (or runbook session) that creates, updates, or deletes data. It does not have any built-in refetch or caching functionality. Mutations are generally executed by an intentional interaction with an Airplane component, such as by clicking on the Button component.