backport of commit 30e63fe (#25917)

hc-github-team-nomad-core · aimeeu · web-flow · commit 3295ab1acd5c · 2025-05-22T11:57:41.000-05:00
Co-authored-by: Aimee Ukasick &lt;aimee.ukasick@hashicorp.com&gt;
diff --git a/website/content/api-docs/acl/roles.mdx b/website/content/api-docs/acl/roles.mdx
@@ -219,7 +219,7 @@ has been replicated to the region, and may lag behind the authoritative region.
 
 | Method | Path                 | Produces           |
 | ------ | -------------------- | ------------------ |
-| `GET`  | `/acl/role/:role_id` | `application/json` |
+| `GET`  | `/v1/acl/role/:role_id` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries),
diff --git a/website/content/api-docs/allocations.mdx b/website/content/api-docs/allocations.mdx
@@ -864,7 +864,7 @@ allocation ID.
 
 | Method | Path                             | Produces           |
 | ------ | -------------------------------- | ------------------ |
-| `GET`  | `/allocation/:alloc_id/services` | `application/json` |
+| `GET`  | `/v1/allocation/:alloc_id/services` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
@@ -919,7 +919,7 @@ to the passed allocation ID.
 
 | Method | Path                           | Produces           |
 | ------ | ------------------------------ | ------------------ |
-| `GET`  | `/allocation/:alloc_id/checks` | `application/json` |
+| `GET`  | `/v1/allocation/:alloc_id/checks` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
diff --git a/website/content/api-docs/jobs.mdx b/website/content/api-docs/jobs.mdx
@@ -2531,7 +2531,7 @@ The endpoint is used to read all services registered within Nomad belonging to t
 
 | Method | Path                    | Produces           |
 | ------ | ----------------------- | ------------------ |
-| `GET`  | `/job/:job_id/services` | `application/json` |
+| `GET`  | `/v1/job/:job_id/services` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
diff --git a/website/content/api-docs/quotas.mdx b/website/content/api-docs/quotas.mdx
@@ -8,10 +8,7 @@ description: The /quota endpoints are used to query for and interact with quotas
 
 The `/quota` endpoints are used to query for and interact with quotas.
 
-<EnterpriseAlert>
-  This API endpoint and functionality only exists in Nomad Enterprise. This is
-  not present in the open source version of Nomad.
-</EnterpriseAlert>
+<EnterpriseAlert product="nomad"/>
 
 ## List Quota Specifications
 
diff --git a/website/content/api-docs/recommendations.mdx b/website/content/api-docs/recommendations.mdx
@@ -11,10 +11,7 @@ description: >-
 The `/recommendation` endpoints are used to query and interact with Dynamic
 Application Sizing recommendations.
 
-<EnterpriseAlert>
-  This API endpoint and functionality only exists in Nomad Enterprise. This is
-  not present in the open source version of Nomad.
-</EnterpriseAlert>
+<EnterpriseAlert product="nomad"/>
 
 ## List Recommendations
 
diff --git a/website/content/api-docs/scaling-policies.mdx b/website/content/api-docs/scaling-policies.mdx
@@ -14,7 +14,7 @@ This endpoint returns the scaling policies from all jobs.
 
 | Method | Path                | Produces           |
 | ------ | ------------------- | ------------------ |
-| `GET`  | `/scaling/policies` | `application/json` |
+| `GET`  | `/v1/scaling/policies` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
@@ -102,7 +102,7 @@ This endpoint reads a specific scaling policy.
 
 | Method | Path                         | Produces           |
 | ------ | ---------------------------- | ------------------ |
-| `GET`  | `/scaling/policy/:policy_id` | `application/json` |
+| `GET`  | `/v1/scaling/policy/:policy_id` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
diff --git a/website/content/api-docs/sentinel-policies.mdx b/website/content/api-docs/sentinel-policies.mdx
@@ -13,10 +13,7 @@ For more details about Sentinel policies, please see the [Sentinel Policy Guide]
 
 Sentinel endpoints are only available when ACLs are enabled. For more details about ACLs, please see the [ACL Guide](/nomad/tutorials/access-control).
 
-<EnterpriseAlert>
-  This API endpoint and functionality only exists in Nomad Enterprise. This is
-  not present in the open source version of Nomad.
-</EnterpriseAlert>
+<EnterpriseAlert product="nomad"/>
 
 ## List Policies
 
@@ -25,7 +22,7 @@ to the region, and may lag behind the authoritative region.
 
 | Method | Path                 | Produces           |
 | ------ | -------------------- | ------------------ |
-| `GET`  | `/sentinel/policies` | `application/json` |
+| `GET`  | `/v1/sentinel/policies` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
@@ -65,7 +62,7 @@ authoritative region.
 
 | Method | Path                            | Produces       |
 | ------ | ------------------------------- | -------------- |
-| `POST` | `/sentinel/policy/:policy_name` | `(empty body)` |
+| `POST` | `/v1/sentinel/policy/:policy_name` | `(empty body)` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries) and
@@ -117,7 +114,7 @@ replicated to the region, and may lag behind the authoritative region.
 
 | Method | Path                            | Produces           |
 | ------ | ------------------------------- | ------------------ |
-| `GET`  | `/sentinel/policy/:policy_name` | `application/json` |
+| `GET`  | `/v1/sentinel/policy/:policy_name` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
@@ -156,7 +153,7 @@ authoritative region.
 
 | Method   | Path                            | Produces       |
 | -------- | ------------------------------- | -------------- |
-| `DELETE` | `/sentinel/policy/:policy_name` | `(empty body)` |
+| `DELETE` | `/v1/sentinel/policy/:policy_name` | `(empty body)` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries) and
diff --git a/website/content/api-docs/services.mdx b/website/content/api-docs/services.mdx
@@ -62,7 +62,7 @@ This endpoint reads a specific service.
 
 | Method | Path                     | Produces           |
 | ------ | ------------------------ | ------------------ |
-| `GET`  | `/service/:service_name` | `application/json` |
+| `GET`  | `/v1/service/:service_name` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries), [consistency modes](/nomad/api-docs#consistency-modes) and
@@ -179,4 +179,4 @@ $ curl \
     https://localhost:4646/v1/service/example-cache-redis/_nomad-task-ba731da0-6df9-9858-ef23-806e9758a899-redis-example-cache-redis-db
 ```
 
-[hash]: https://en.wikipedia.org/wiki/Rendezvous_hashing
+[hash]: https://en.wikipedia.org/wiki/Rendezvous_hashing
diff --git a/website/content/api-docs/status.mdx b/website/content/api-docs/status.mdx
@@ -14,7 +14,7 @@ This endpoint returns the address of the current leader in the region.
 
 | Method | Path             | Produces           |
 | ------ | ---------------- | ------------------ |
-| `GET`  | `/status/leader` | `application/json` |
+| `GET`  | `/v1/status/leader` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries) and
@@ -43,7 +43,7 @@ This endpoint returns the set of raft peers in the region.
 
 | Method | Path            | Produces           |
 | ------ | --------------- | ------------------ |
-| `GET`  | `/status/peers` | `application/json` |
+| `GET`  | `/v1/status/peers` | `application/json` |
 
 The table below shows this endpoint's support for
 [blocking queries](/nomad/api-docs#blocking-queries) and
diff --git a/website/content/api-docs/ui.mdx b/website/content/api-docs/ui.mdx
@@ -6,7 +6,8 @@ description: The /ui namespace is used to access the Nomad web user interface.
 
 # Nomad Web UI
 
-The Nomad UI is accessible at `/ui`. It is not namespaced by version. A request to `/` will also redirect to `/ui`.
+The Nomad UI is accessible at `/ui`. It is not namespaced by version, so do not
+prepend `/vi` to this endpoint. A request to `/` redirects to `/ui`.
 
 ## List Jobs
 
@@ -559,7 +560,7 @@ authenticate all future requests to allow read access to additional resources.
 
 The Nomad UI supports several keyboard shortcuts in order to help users navigate and operate Nomad. You can use common key commands to dig into jobs, view logs, monitor evaluations, and more.
 
-Type `?` from anywhere in the UI to launch the Keyboard Shortcuts panel. 
+Type `?` from anywhere in the UI to launch the Keyboard Shortcuts panel.
 
 ### Default key commands:
 
