About Data Exchange Explorer
Data Exchange Explorer is an interactive browser-based user interface for exploring and executing GraphQL queries against the Data Exchange API. It includes an auto-complete feature, which automatically suggests potential fields as you type a query. It connects to your live Data Exchange Hubs, which allows you to work with your actual Data Exchange data.
Important: Data Exchange Explorer accesses your production data.
Using Data Exchange Explorer
To use the Data Exchange Explorer:
- Use your Autodesk credentials to sign in to Data Exchange Explorer.
- Add the client id
HKVjhUXySDGLGJimolxAgDdpoCuZLlql
to your Autodesk Construction Cloud (ACC) by following these steps.
User Interaction Elements
This section describes the GUI elements of the explorer, such as panes, tabs, buttons, toggle button for viewer, etc.
Explorer Panes
The following image illustrates the elements of Explorer pane.

For a detailed explanation of each element of Explorer pane, refer to the following table.
No. | Interaction Elements | Description |
---|---|---|
1 | Query Pane | The pane where you can author GraphQL queries. |
2 | Query Variables & Request Headers Pane | The pane where you can add and edit Query Variables or additional Request Headers. |
3 | Results Pane | Displays response of the executed queries. |
Interactive Elements
Following screenshot illustrates important User Interaction (UI) elements of the explorer.

For a detailed explanation of each each UI element, refer to the following table.
No. | Interaction Elements | Description |
---|---|---|
1 | Documentation Explorer Button | Displays the user documentation pane. |
2 | History Button | Displays history of queries recently sent in the left side of the screen. |
3 | Prettify Button | Reformats the query for readability. |
4 | Play Button | Runs the query and displays response in the result pane. |
5 | Merge Button | Merges any GraphQL fragments into the query. |
6 | Copy Button | Copies the query present in the Query Pane. |
7 | Exchange File URN Input | Accepts the Exchange file URN that you want to load in the model viewer. |
8 | Model Viewer Toggle | Toggle button to show or hide the model viewer. |
9 | Settings Dialog | Displays configurations for the UI theme and Data Cache. |
10 | Short Keys Guide | Displays guide which breaks down keyboard shortcuts for quick functionalities. |
11 | Re-fetch Button | Re-fetches the GraphQL Schema. |
12 | Query Variables Tab | The tab where you can add and edit Query Variables. |
13 | Request Headers Tab | The tab where you can add and edit additional Request Headers. |
Tip: You can view the user documentation of a particular term by holding Control (on Windows) or Command (on macOS) key on your keyboard and clicking the term. After clicking, the Documentation Explorer appears on the right side of the screen. You can also use the Viewer button to toggle the model preview.
After Documentation Explorer opens, you should see an image similar to the following screen.

For a detailed explanation of the fields in above image, refer to the following table.
No. | Interaction Elements | Description |
---|---|---|
1 | Documentation Explorer Button | Displays the user documentation pane. |
2 | Documentation Explorer | Displays user documentation on the fly when working with queries within the Data Exchange Explorer. |
3 | Query Term | A valid schema term which can be described using the Query Pane Term Viewer. |
4 | Query Pane Term Viewer | Using the keyboard short key and selecting a term, displays the definition of the respective term within the Query Pane. |
Sending Queries
- In the Query Pane, enter your query. As you enter the query, autocomplete assists you in completing the query.
- In the Query Variables Pane, specify the variable and its value in JSON format.
Note: The Query Variable Pane is collapsed by default, so click QUERY VARIABLES to expand the Query Variable Pane.
- Click Play to send the query to the GraphQL server. The response is displayed in the pane on the right.
Handling Token Expiration
The Data Exchange Explorer handles access tokens transparently. If you are notified that the access token has expired, refresh the browser or close the browser and sign in again. If the problem persists, try clearing your browser’s cache before signing in again.