diff --git a/assets/images/developer/graphiql-headers.png b/assets/images/developer/graphiql-headers.png deleted file mode 100644 index 7f07a7ba00..0000000000 Binary files a/assets/images/developer/graphiql-headers.png and /dev/null differ diff --git a/assets/images/developer/graphql/insomnia-base-url-and-pat.png b/assets/images/developer/graphql/insomnia-base-url-and-pat.png index f5dff22809..dd5af928dd 100644 Binary files a/assets/images/developer/graphql/insomnia-base-url-and-pat.png and b/assets/images/developer/graphql/insomnia-base-url-and-pat.png differ diff --git a/assets/images/developer/graphql/insomnia-bearer-token-option.png b/assets/images/developer/graphql/insomnia-bearer-token-option.png index cc2aa638b0..d003e120ae 100644 Binary files a/assets/images/developer/graphql/insomnia-bearer-token-option.png and b/assets/images/developer/graphql/insomnia-bearer-token-option.png differ diff --git a/assets/images/developer/graphql/json-content-type-header.png b/assets/images/developer/graphql/json-content-type-header.png index 2b8ae32ed9..efc8104af3 100644 Binary files a/assets/images/developer/graphql/json-content-type-header.png and b/assets/images/developer/graphql/json-content-type-header.png differ diff --git a/assets/images/developer/graphql/preview-header-for-2.18.png b/assets/images/developer/graphql/preview-header-for-2.18.png deleted file mode 100644 index 674385a83a..0000000000 Binary files a/assets/images/developer/graphql/preview-header-for-2.18.png and /dev/null differ diff --git a/content/graphql/guides/managing-enterprise-accounts.md b/content/graphql/guides/managing-enterprise-accounts.md index 9534ea7698..705aac19bf 100644 --- a/content/graphql/guides/managing-enterprise-accounts.md +++ b/content/graphql/guides/managing-enterprise-accounts.md @@ -53,7 +53,7 @@ For some example queries, see "[An example query using the Enterprise Accounts A 1. To authenticate with GraphQL, you need to generate a {% data variables.product.pat_generic %} from developer settings. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." -2. Grant admin and full control permissions to your {% data variables.product.pat_generic %} for areas of GHES you'd like to access. For full permission to private repositories, organizations, teams, user data, and access to enterprise billing and profile data, we recommend you select these scopes for your {% data variables.product.pat_generic %}: +2. Grant admin and full control permissions to your {% data variables.product.pat_generic %} for areas of your enterprise you'd like to access. For full permission to private repositories, organizations, teams, user data, and access to enterprise billing and profile data, we recommend you select these scopes for your {% data variables.product.pat_generic %}: - `repo` - `admin:org` - `user` @@ -84,16 +84,15 @@ The next steps will use Insomnia. - For your enterprise instance: `https:///api/graphql` - For GitHub Enterprise Cloud: `https://api.github.com/graphql` -2. To authenticate, open the authentication options menu and select **Bearer token**. Next, add your {% data variables.product.pat_generic %} that you copied earlier. - - ![Permissions options for {% data variables.product.pat_generic %}](/assets/images/developer/graphql/insomnia-base-url-and-pat.png) - - ![Permissions options for {% data variables.product.pat_generic %}](/assets/images/developer/graphql/insomnia-bearer-token-option.png) - -3. Include header information. - - Add `Content-Type` as the header and `application/json` as the value. - ![Standard header](/assets/images/developer/graphql/json-content-type-header.png) - ![Header with preview value for the Audit Log API](/assets/images/developer/graphql/preview-header-for-2.18.png) +1. Select the "Auth" menu and click **Bearer Token**. If you've previously selected a different authentication method, the menu will be labeled with that method, such as "Basic Auth", instead. + ![Screenshot of the expanded "Auth" menu in Insomnia. The menu label, "Auth", and the "Bearer Token" option are outlined in dark orange.](/assets/images/developer/graphql/insomnia-bearer-token-option.png) +1. In the "TOKEN" field, enter your {% data variables.product.pat_generic %} from an earlier step. + ![Screenshot of the "Bearer" authentication settings in Insomnia. The "TOKEN" field is outlined in dark orange.](/assets/images/developer/graphql/insomnia-base-url-and-pat.png) +1. Click **Headers**. + ![Screenshot of the settings tabs in Insomnia. The "Headers" tab is outlined in dark orange.](/assets/images/developer/graphql/json-content-type-header.png) +1. Under the **Headers** tab, click **Add**. +1. In the "header" field, enter `Content-Type`. +1. In the "value" field, enter `application/json`. Now you are ready to start making queries. diff --git a/content/graphql/guides/using-the-explorer.md b/content/graphql/guides/using-the-explorer.md index 47a506f1f7..38dba5a9c7 100644 --- a/content/graphql/guides/using-the-explorer.md +++ b/content/graphql/guides/using-the-explorer.md @@ -33,8 +33,8 @@ To use the GraphiQL app, download and install it from https://github.com/skevy/g 1. Get an [OAuth token](/graphql/guides/forming-calls-with-graphql#authenticating-with-graphql). 1. Launch GraphiQL. 1. In the upper-right corner of GraphiQL, click **Edit HTTP Headers**. -1. In the **Key** field, enter `Authorization`. In the **Value** field, enter `Bearer `, where `` is your generated OAuth token. -![graphiql headers](/assets/images/developer/graphiql-headers.png) +1. In the **Key** field, enter `Authorization`. +1. In the **Value** field, enter `Bearer TOKEN`, replacing `TOKEN` with your OAuth token from the first step. 1. Click the checkmark to the right of the token to save it. 1. To return to the editor, click outside of the **Edit HTTP Headers** modal. 1. In the **GraphQL Endpoint** field, enter `{% data variables.product.graphql_url_pre %}`.