From e3d765374bfc56ed1d01c1a5a1fa741209488ea0 Mon Sep 17 00:00:00 2001 From: Kalan <51868853+kalanchan@users.noreply.github.com> Date: Wed, 16 Jul 2025 11:28:20 -0700 Subject: [PATCH 1/3] update SAT creation instructions --- docs/analytics/api.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/analytics/api.mdx b/docs/analytics/api.mdx index ee1c1c749..aa78c1638 100644 --- a/docs/analytics/api.mdx +++ b/docs/analytics/api.mdx @@ -4,11 +4,11 @@ The Sourcegraph Analytics API is an API that provides programmatic access to you ## Access tokens -For Sourcegraph Analytics, you can generate an access token for programmatic access. Tokens are long-lived with an optional expiry and have the same permissions to access instance data as the user who created them. +For Sourcegraph Analytics, you can generate an access token for programmatic access using your session cookie. Tokens are long-lived with an optional expiry and have the same permissions to access instance data as the user who created them. -### Token management APIs +### Getting Started -Token management is currently only available via the Sourcegraph Analytics API. Token management APIs are authenticated via the `cas` session cookie. +Tokens are first retrieved via the `cas` session cookie and then used to generate a long-lived access token. Token management is currently only available via the Sourcegraph Analytics API. - Sign in to [Sourcegraph Analytics](https://analytics.sourcegraph.com). - Retrieve your session cookie, `cas`, from your browser's developer tools. From b2d6d3599701d57a4cf2a43da41f5446cd50d376 Mon Sep 17 00:00:00 2001 From: Kalan <51868853+kalanchan@users.noreply.github.com> Date: Mon, 21 Jul 2025 11:24:27 -0700 Subject: [PATCH 2/3] Update docs/analytics/api.mdx Co-authored-by: James Cotter <35706755+jac@users.noreply.github.com> --- docs/analytics/api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/analytics/api.mdx b/docs/analytics/api.mdx index aa78c1638..e42ce75fb 100644 --- a/docs/analytics/api.mdx +++ b/docs/analytics/api.mdx @@ -8,7 +8,7 @@ For Sourcegraph Analytics, you can generate an access token for programmatic acc ### Getting Started -Tokens are first retrieved via the `cas` session cookie and then used to generate a long-lived access token. Token management is currently only available via the Sourcegraph Analytics API. +Access tokens are created using the `cas` cookie for authentication to the token creation endpoint. Access tokens are longer lived than the `cas` cookie making them more suitable for programmatic access to the Sourcegraph Analytics API. - Sign in to [Sourcegraph Analytics](https://analytics.sourcegraph.com). - Retrieve your session cookie, `cas`, from your browser's developer tools. From 47e3560f95ac523ab322e9524f3eefe0a5321d81 Mon Sep 17 00:00:00 2001 From: Kalan <51868853+kalanchan@users.noreply.github.com> Date: Mon, 21 Jul 2025 11:40:23 -0700 Subject: [PATCH 3/3] Update docs/analytics/api.mdx Co-authored-by: James Cotter <35706755+jac@users.noreply.github.com> --- docs/analytics/api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/analytics/api.mdx b/docs/analytics/api.mdx index e42ce75fb..54aa3d08b 100644 --- a/docs/analytics/api.mdx +++ b/docs/analytics/api.mdx @@ -4,7 +4,7 @@ The Sourcegraph Analytics API is an API that provides programmatic access to you ## Access tokens -For Sourcegraph Analytics, you can generate an access token for programmatic access using your session cookie. Tokens are long-lived with an optional expiry and have the same permissions to access instance data as the user who created them. +For Sourcegraph Analytics, you can generate an access token for programmatic access. Tokens are long-lived with an optional expiry and have the same permissions to access instance data as the user who created them. ### Getting Started