GITBOOK-9152: API: Update navigation to reflect use of authetication and changelog for REST and V! , REST API page

Author: awileysnyk

docs/SUMMARY.md

@@ -970,11 +970,11 @@
   * [REST API](snyk-api/rest-api/README.md)
     * [About the REST API](snyk-api/rest-api/about-the-rest-api.md)
     * [Getting started with the REST API](snyk-api/rest-api/getting-started-with-the-rest-api.md)
-    * [Authentication for API](snyk-api/rest-api/authentication-for-api/README.md)
-      * [Snyk API token permissions users can control](snyk-api/rest-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md)
-      * [Revoke and regenerate a Snyk API token](snyk-api/rest-api/authentication-for-api/revoke-and-regenerate-a-snyk-api-token.md)
-    * [Changelog](snyk-api/rest-api/changelog.md)
   * [V1 API](snyk-api/v1-api.md)
+  * [Authentication for API](snyk-api/authentication-for-api/README.md)
+    * [Snyk API token permissions users can control](snyk-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md)
+    * [Revoke and regenerate a Snyk API token](snyk-api/authentication-for-api/revoke-and-regenerate-a-snyk-api-token.md)
+  * [Changelog](snyk-api/changelog.md)
   * [OAuth2 API](snyk-api/oauth2-api.md)
   * [Reference](snyk-api/reference/README.md)
     * [Apps](snyk-api/reference/apps.md)

docs/enterprise-setup/service-accounts/README.md

@@ -84,7 +84,7 @@ From the **Role** dropdown list, select an appropriate role.
 
 For Group service accounts, choose from the following list of roles to configure the scope of the token; Snyk recommends selecting Viewer or Admin.
 
-* **Group Viewer** enables read-only access. Note that to set an API token to be read-only and unable to write to the platform, you must use a service account and set it to Group Viewer. See [Snyk API token permissions users can control](../../snyk-api/rest-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md).
+* **Group Viewer** enables read-only access. Note that to set an API token to be read-only and unable to write to the platform, you must use a service account and set it to Group Viewer. See [Snyk API token permissions users can control](../../snyk-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md).
 * **Group Admin** enables full administrator access.
 * **Group Member** associates a service account with a group but does not grant any specific access.
 

docs/getting-started/README.md

@@ -77,7 +77,7 @@ To obtain your personal Snyk API token:
 
 If you want a new API token, select **Revoke & Regenerate**, but be aware that this will make the previous API token invalid.
 
-For information on when to use an API token and when to use a service account token, available to Enterprise plan users only, see [Authentication for API](../snyk-api/rest-api/authentication-for-api/).
+For information on when to use an API token and when to use a service account token, available to Enterprise plan users only, see [Authentication for API](../snyk-api/authentication-for-api/).
 
 ## Import a Project to scan and identify issues
 

docs/scan-with-snyk/snyk-open-source/snyk-for-bazel/dep-graph-api.md

@@ -12,7 +12,7 @@ To test and monitor dependencies managed by [Bazel](./), it is recommended that
 Follow these basic steps:
 
 1. For each type of dependency, for example, Maven, Cocoapods, create a [Dep Graph JSON object](https://github.com/snyk/dep-graph) listing all the dependency packages and versions. See [Example of Snyk for Baszel](dep-graph-api.md#example-of-snyk-for-bazel).
-2.  As part of a Bazel test rule, send the Dep Graph JSON object as a POST request to the endpoint [Test Dep Graph](../../../snyk-api/reference/test-v1.md#test-dep-graph), along with your [auth token](../../../snyk-api/rest-api/authentication-for-api/). An example curl request follows:
+2.  As part of a Bazel test rule, send the Dep Graph JSON object as a POST request to the endpoint [Test Dep Graph](../../../snyk-api/reference/test-v1.md#test-dep-graph), along with your [auth token](../../../snyk-api/authentication-for-api/). An example curl request follows:
 
     ```
     curl -X POST 'https://api.snyk.io/v1/test/dep-graph' \

docs/scm-ide-and-ci-cd-integrations/snyk-ci-cd-integrations/snyk-ci-cd-integration-deployment-and-strategies/ci-cd-setup.md

@@ -49,7 +49,7 @@ To continuously avoid known vulnerabilities in your dependencies, integrate Snyk
 
 ### Set up automatic monitoring
 
-If you monitor a Project with Snyk, you will be notified if the dependencies in your Project are affected by newly disclosed vulnerabilities. To ensure the list of dependencies Snyk has for your Open Source Project is up to date, refresh it continuously by running `snyk monitor` in your deployment process. Configure your environment to include the `SNYK_TOKEN` environment variable. You can [find your API token ](../../../snyk-api/rest-api/authentication-for-api/)in your Snyk account settings.
+If you monitor a Project with Snyk, you will be notified if the dependencies in your Project are affected by newly disclosed vulnerabilities. To ensure the list of dependencies Snyk has for your Open Source Project is up to date, refresh it continuously by running `snyk monitor` in your deployment process. Configure your environment to include the `SNYK_TOKEN` environment variable. You can [find your API token ](../../../snyk-api/authentication-for-api/)in your Snyk account settings.
 
 ### API token configuration
 

docs/scm-ide-and-ci-cd-integrations/snyk-scm-integrations/github-server-app.md

@@ -141,7 +141,7 @@ To set up the integration you will need the following:
 
 * The base API address for your Snyk region; refer to the list of [API URLs](../../working-with-snyk/regional-hosting-and-data-residency.md#api-urls) for Snyk regional hosting.
 * The Snyk Organization ID you want to set up the integration in.
-* A valid [Snyk API token](../../snyk-api/rest-api/authentication-for-api/#how-to-obtain-your-personal-token).
+* A valid [Snyk API token](../../snyk-api/authentication-for-api/#how-to-obtain-your-personal-token).
 * `snyk-broker-config` tool installed
 * Tenant Admin role
 

docs/snyk-api/rest-api/authentication-for-api/README.md renamed to docs/snyk-api/authentication-for-api/README.md

@@ -7,18 +7,18 @@ To use the Snyk API, you must be an Enterprise plan customer and have a token fr
 {% endhint %}
 
 {% hint style="warning" %}
-Use the URL for your region when calling an API. See [API URLs](../about-the-rest-api.md#api-urls).
+Use the URL for your region when calling an API. See [API URLs](../rest-api/about-the-rest-api.md#api-urls).
 {% endhint %}
 
-Enterprise users have [access to a personal token under their profile](./#how-to-obtain-your-personal-token) and to service account tokens. The personal API token is associated with your Snyk Account and not with a specific Organization. Service accounts are associated with an Organization or a Group. For more information, see [Service accounts](../../../enterprise-setup/service-accounts/).
+Enterprise users have [access to a personal token under their profile](./#how-to-obtain-your-personal-token) and to service account tokens. The personal API token is associated with your Snyk Account and not with a specific Organization. Service accounts are associated with an Organization or a Group. For more information, see [Service accounts](../../enterprise-setup/service-accounts/).
 
 * **Enterprise users should use a service account** to authenticate for any kind of automation. This includes, but is not limited to, CI/CD scanning with the CLI or build system plugins and any automation, including automation with the API.
 * **Enterprise users should use the personal token** under their user profile for:
-  * Running the CLI locally on their machine; for details, see [Authenticate to use the CLI](../../../snyk-cli/authenticate-to-use-the-cli.md).
+  * Running the CLI locally on their machine; for details, see [Authenticate to use the CLI](../../snyk-cli/authenticate-to-use-the-cli.md).
   * Authenticating with the IDE manually
   * Running API calls one time, for example, to test something
 
-Note that for free and team plan users, the personal token does not have access to the API and may be used for authenticating to IDE, CLI, and CI/CD integrations only. For details, see [Obtain and use your API token](../../../getting-started/#obtain-and-use-your-snyk-api-token).
+Note that for free and team plan users, the personal token does not have access to the API and may be used for authenticating to IDE, CLI, and CI/CD integrations only. For details, see [Obtain and use your API token](../../getting-started/#obtain-and-use-your-snyk-api-token).
 
 For additional information, see [Snyk API token permissions users can control](snyk-api-token-permissions-users-can-control.md).
 
@@ -41,7 +41,7 @@ curl --request GET \
 
 ## Authenticating for Snyk Apps
 
-If you are using the [Snyk Apps APIs](../../using-specific-snyk-apis/snyk-apps-apis/), provide the `access_token` in an `Authorization: bearer` header as follows:
+If you are using the [Snyk Apps APIs](../using-specific-snyk-apis/snyk-apps-apis/), provide the `access_token` in an `Authorization: bearer` header as follows:
 
 ```bash
 curl --request GET \

docs/snyk-api/rest-api/authentication-for-api/revoke-and-regenerate-a-snyk-api-token.md renamed to docs/snyk-api/authentication-for-api/revoke-and-regenerate-a-snyk-api-token.md

@@ -8,6 +8,6 @@ If you suspect an API token has been leaked, it is good practice to revoke that
 
 To revoke your Snyk user API token, navigate to your personal General Account Settings in the Snyk Web UI at [app.snyk.io/account](https://app.snyk.io/account).
 
-![API token screen, Revoke & Regenerate button](../../../.gitbook/assets/account-settings-general-auth-token.png)
+![API token screen, Revoke & Regenerate button](../../.gitbook/assets/account-settings-general-auth-token.png)
 
 Click the **Revoke & Regenerate** button to revoke your API token. A new one will be generated in its place. You can now copy the newly generated API token and update integrations that used the old token.

docs/snyk-api/rest-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md renamed to docs/snyk-api/authentication-for-api/snyk-api-token-permissions-users-can-control.md

@@ -4,4 +4,4 @@ To set an API token to have read-only permissions so the user is unable to write
 
 Service accounts at the Organization level have only Organization Admin and Organization Collaborator permissions. Thus, to set a service account to view only, you must use a Group-level service account.
 
-For more information see [Service accounts](../../../enterprise-setup/service-accounts/).
+For more information see [Service accounts](../../enterprise-setup/service-accounts/).