--- category: [Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend] keyword: [Extend, Workday Graph API, Graph API, GraphQL] nav: wcp_docs parent_url: /wcp_docs/ title: Generate Queries on Graph API Explorer layout: subsection --- ### Prerequisites Ensure that you've configured security policies for the domains that control access to the business objects in the query or mutation you want to generate. The field descriptions in the Graph API schema documentation list the required security domains. ### Context The Generate Query panel on the Graph API Explorer helps you build a query or mutation. ### Steps 1. On the left sidebar of the Graph API Explorer, click the Show Generate Query icon. 2. On the Filter Fields box, type the query or mutation. 3. Select any of these options:

Option Description

Generated Depth Adds field levels up to the specified number.

Option	Description
Generated Depth	Adds field levels up to the specified number.
Show Only Required Input Fields	By default, a generated mutation includes all input fields. A generated query includes the optional `where`, `limit`, `offset`, and `orderBy` fields. If you select Show Only Required Fields, the generated query or mutation includes only the required input fields.
Include Variables in Query	By default, the generated query or mutation uses a variable for each argument. Note that query variables begin with $. Query variables are useful for sending dynamic data to the query arguments. The Query panel displays all variables in the Variables section. If you select Include Variables in Query, the generated query replaces all $ variables inside the query with their corresponding fields and placeholder values. This option embeds the argument fields inside the query or mutation. You can select this option for simpler queries or if you don't need to use query variables.

Show Only Required Input Fields

By default, a generated mutation includes all input fields. A generated query includes the optional where, limit, offset, and orderBy fields.

If you select Show Only Required Fields, the generated query or mutation includes only the required input fields.

Include Variables in Query

By default, the generated query or mutation uses a variable for each argument. Note that query variables begin with $. Query variables are useful for sending dynamic data to the query arguments. The Query panel displays all variables in the Variables section.

If you select Include Variables in Query, the generated query replaces all $ variables inside the query with their corresponding fields and placeholder values.

This option embeds the argument fields inside the query or mutation. You can select this option for simpler queries or if you don't need to use query variables.

4. Click a query or mutation from the filtered list. ### Result The Query panel displays the generated query or mutation. If you change a query generation option, click the query or mutation from the filtered list to regenerate. The Query panel displays the generated query or mutation in a new tab. ### Next Steps 1. Refine the query or mutation. Remove unnecessary fields, and replace the placeholder values. 2. Test the query or mutation by clicking the Execute query icon on the Query panel. Alternatively, press Ctrl+Enter. 3. If the query or mutation is successful, copy it to your Extend app. To copy a multi-line query string to a PMD endpoint, click Copy Query. To copy a single-line JSON map containing the query and variables, click Copy JSON. ### Related Information [Graph API Queries](/wcp_docs/qxq1671067079349.html) [Graph API Mutations](/wcp_docs/kbu1671067116723.html)