🤖 sync'ing generated docs

buildkite-at-sourcegraph · buildkite-at-sourcegraph · commit 2bb4543f6193 · 2026-04-07T04:53:50.000Z
diff --git a/docs/admin/code-hosts/aws-codecommit.mdx b/docs/admin/code-hosts/aws-codecommit.mdx
@@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// REQUIRED:
diff --git a/docs/admin/code-hosts/azuredevops.mdx b/docs/admin/code-hosts/azuredevops.mdx
@@ -65,7 +65,7 @@ Azure DevOps connections support the following configuration options, which are
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 	// Authentication alternatives: token OR windowsPassword
 
diff --git a/docs/admin/code-hosts/bitbucket-cloud.mdx b/docs/admin/code-hosts/bitbucket-cloud.mdx
@@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// The workspace access token to use when authenticating with Bitbucket Cloud.
diff --git a/docs/admin/code-hosts/bitbucket-server.mdx b/docs/admin/code-hosts/bitbucket-server.mdx
@@ -202,7 +202,7 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_server.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 	// Authentication alternatives: token OR password
 
diff --git a/docs/admin/code-hosts/gerrit.mdx b/docs/admin/code-hosts/gerrit.mdx
@@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
diff --git a/docs/admin/code-hosts/github.mdx b/docs/admin/code-hosts/github.mdx
@@ -454,7 +454,7 @@ GitHub connections support the following configuration options, which are specif
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/github.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 	// Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount
 
diff --git a/docs/admin/code-hosts/gitlab.mdx b/docs/admin/code-hosts/gitlab.mdx
@@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
diff --git a/docs/admin/code-hosts/gitolite.mdx b/docs/admin/code-hosts/gitolite.mdx
@@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).
diff --git a/docs/admin/code-hosts/other.mdx b/docs/admin/code-hosts/other.mdx
@@ -68,7 +68,7 @@ Repositories must be listed individually:
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".*secret.*"}).
diff --git a/docs/admin/code-hosts/phabricator.mdx b/docs/admin/code-hosts/phabricator.mdx
@@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
diff --git a/docs/admin/config/settings.mdx b/docs/admin/config/settings.mdx
@@ -27,7 +27,7 @@ Settings options and their default values are shown below.
 
 {/* SCHEMA_SYNC_START: admin/config/settings.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 
diff --git a/docs/admin/config/site-config.mdx b/docs/admin/config/site-config.mdx
@@ -21,7 +21,7 @@ All site configuration options and their default values are shown below.
 
 {/* SCHEMA_SYNC_START: admin/config/site.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 
diff --git a/docs/admin/repo/perforce.mdx b/docs/admin/repo/perforce.mdx
@@ -228,7 +228,7 @@ With this setting, Sourcegraph will ignore any rules with a host other than `*`,
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/perforce.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-07T04:53:49Z */}
 ```json
 {
 	// If non-null, enforces Perforce depot permissions.
diff --git a/docs/cli/references/auth.mdx b/docs/cli/references/auth.mdx
@@ -0,0 +1,22 @@
+# `src auth`
+
+
+
+## Usage
+
+```
+'src auth' provides authentication-related helper commands.
+
+Usage:
+
+	src auth command [command options]
+
+The commands are:
+
+	token   prints the current authentication token
+
+Use "src auth [command] -h" for more information about a command.
+
+
+```
+	
diff --git a/docs/cli/references/index.mdx b/docs/cli/references/index.mdx
@@ -5,6 +5,7 @@
 
 * [`admin`](references/admin)
 * [`api`](references/api)
+* [`auth`](references/auth)
 * [`batch`](references/batch)
 * [`code-intel`](references/code-intel)
 * [`codeowners`](references/codeowners)
diff --git a/docs/cli/references/login.mdx b/docs/cli/references/login.mdx
@@ -19,7 +19,7 @@
 
 Usage:
 
-    src login SOURCEGRAPH_URL
+    src login [flags] SOURCEGRAPH_URL
 
 Examples:
 
@@ -31,6 +31,10 @@ Examples:
 
     $ src login https://sourcegraph.com
 
+  If no access token is configured, 'src login' uses OAuth device flow automatically:
+
+    $ src login https://sourcegraph.com
+
   -dump-requests
     	Log GraphQL requests and responses to stdout
   -get-curl
diff --git a/docs/self-hosted/observability/alerts.mdx b/docs/self-hosted/observability/alerts.mdx
@@ -6840,6 +6840,42 @@ Generated query for critical alert: `max((sum(rate(src_deepsearch_question_proce
 
 <br />
 
+## deepsearch: deepsearch_errored_but_billed_rate
+
+<p class="subtitle">errored but billed rate over 5m</p>
+
+**Descriptions**
+
+- <span class="badge badge-warning">warning</span> deepsearch: 5%+ errored but billed rate over 5m for 10m0s
+- <span class="badge badge-critical">critical</span> deepsearch: 95%+ errored but billed rate over 5m for 10m0s
+
+**Next steps**
+
+- Check for upstream LLM provider issues causing token limit or truncation errors.
+- Review `deepsearch_question_outcome_by_reason` for outcome breakdown.
+- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_errored_but_billed_rate).
+- **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:
+
+```json
+"observability.silenceAlerts": [
+  "warning_deepsearch_deepsearch_errored_but_billed_rate",
+  "critical_deepsearch_deepsearch_errored_but_billed_rate"
+]
+```
+
+<sub>*Managed by the Sourcegraph Code Understanding team.*</sub>
+
+<details>
+<summary>Technical details</summary>
+
+Generated query for warning alert: `max((sum(rate(src_deepsearch_question_outcome_total{billable="true",error="true"\}[5m])) / (sum(rate(src_deepsearch_question_outcome_total\{billable="true"}[5m])) &gt; 0) * 100) &gt; 5)`
+
+Generated query for critical alert: `max((sum(rate(src_deepsearch_question_outcome_total{billable="true",error="true"\}[5m])) / (sum(rate(src_deepsearch_question_outcome_total\{billable="true"}[5m])) &gt; 0) * 100) &gt; 95)`
+
+</details>
+
+<br />
+
 ## deepsearch: deepsearch_llm_stream_fatal_errors
 
 <p class="subtitle">fatal LLM stream errors over 5m</p>
diff --git a/docs/self-hosted/observability/dashboards.mdx b/docs/self-hosted/observability/dashboards.mdx

Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar`
`37`	`37`
`38`	`38`	`{/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}`
`39`	`39`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`40`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`40`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`41`	`41`	```json
`42`	`42`	`{`
`43`	`43`	`// REQUIRED:`
Original file line number	Diff line number	Diff line change
`@@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a`
`116`	`116`
`117`	`117`	`{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}`
`118`	`118`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`119`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`119`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`120`	`120`	```json
`121`	`121`	`{`
`122`	`122`	`// The workspace access token to use when authenticating with Bitbucket Cloud.`
Original file line number	Diff line number	Diff line change
`@@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif`
`113`	`113`
`114`	`114`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}`
`115`	`115`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`116`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`116`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`117`	`117`	```json
`118`	`118`	`{`
`119`	`119`	// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
Original file line number	Diff line number	Diff line change
`@@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).`
`189`	`189`
`190`	`190`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}`
`191`	`191`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`192`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`192`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`193`	`193`	```json
`194`	`194`	`{`
`195`	`195`	// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:`
`25`	`25`
`26`	`26`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}`
`27`	`27`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`28`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`28`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`29`	`29`	```json
`30`	`30`	`{`
`31`	`31`	`// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).`
Original file line number	Diff line number	Diff line change
`@@ -68,7 +68,7 @@ Repositories must be listed individually:`
`68`	`68`
`69`	`69`	`{/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}`
`70`	`70`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`71`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`71`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`72`	`72`	```json
`73`	`73`	`{`
`74`	`74`	`// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".secret."}).`
Original file line number	Diff line number	Diff line change
@@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config
`76`	`76`
`77`	`77`	`{/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}`
`78`	`78`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`79`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`79`	`+{/* Last updated: 2026-04-07T04:53:49Z */}`
`80`	`80`	```json
`81`	`81`	`{`
`82`	`82`	// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.