diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index d4908f251a..7a029f0a7b 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -52411,6 +52411,9 @@
         ]
       },
       "_types.Duration": {
+        "externalDocs": {
+          "url": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/api-conventions.html#time-units"
+        },
         "description": "A duration. Units can be `nanos`, `micros`, `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours) and\n`d` (days). Also accepts \"0\" without a unit and \"-1\" to indicate an unspecified value.",
         "oneOf": [
           {
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index e3781d18b3..6153df603f 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -28440,6 +28440,9 @@
         ]
       },
       "_types.Duration": {
+        "externalDocs": {
+          "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#time-units"
+        },
         "description": "A duration. Units can be `nanos`, `micros`, `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours) and\n`d` (days). Also accepts \"0\" without a unit and \"-1\" to indicate an unspecified value.",
         "oneOf": [
           {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 2b93c6a2f3..0e0465e3a1 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -50622,11 +50622,13 @@
       "description": "A duration. Units can be `nanos`, `micros`, `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours) and\n`d` (days). Also accepts \"0\" without a unit and \"-1\" to indicate an unspecified value.",
       "docId": "time-value",
       "docUrl": "https://github.com/elastic/elasticsearch/blob/{branch}/libs/core/src/main/java/org/elasticsearch/core/TimeValue.java",
+      "extDocId": "time-units",
+      "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/api-conventions.html#time-units",
       "name": {
         "name": "Duration",
         "namespace": "_types"
       },
-      "specLocation": "_types/Time.ts#L52-L58",
+      "specLocation": "_types/Time.ts#L52-L59",
       "type": {
         "kind": "union_of",
         "items": [
@@ -50655,7 +50657,7 @@
         "name": "DurationLarge",
         "namespace": "_types"
       },
-      "specLocation": "_types/Time.ts#L60-L65",
+      "specLocation": "_types/Time.ts#L61-L66",
       "type": {
         "kind": "instance_of",
         "type": {
@@ -50676,7 +50678,7 @@
         "name": "DurationValue",
         "namespace": "_types"
       },
-      "specLocation": "_types/Time.ts#L67-L67",
+      "specLocation": "_types/Time.ts#L68-L68",
       "type": {
         "kind": "instance_of",
         "type": {
@@ -57816,7 +57818,7 @@
         "name": "TimeUnit",
         "namespace": "_types"
       },
-      "specLocation": "_types/Time.ts#L69-L77"
+      "specLocation": "_types/Time.ts#L70-L78"
     },
     {
       "kind": "type_alias",
diff --git a/specification/_doc_ids/table.csv b/specification/_doc_ids/table.csv
index 903bd4cc20..bdaa8c1b55 100644
--- a/specification/_doc_ids/table.csv
+++ b/specification/_doc_ids/table.csv
@@ -888,6 +888,7 @@ tasks,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/tasks.htm
 templating-role-query,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/field-and-document-access-control.html#templating-role-query,,
 terminate-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/terminate-processor.html,,
 test-grok-pattern,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/test-grok-pattern.html,,
+time-units,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/api-conventions.html#time-units,,Time units
 time-value,https://github.com/elastic/elasticsearch/blob/{branch}/libs/core/src/main/java/org/elasticsearch/core/TimeValue.java,,
 time-zone-id,https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html,,
 transform-set-upgrade-mode,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-transform-set-upgrade-mode,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/transform-set-upgrade-mode.html,
diff --git a/specification/_types/Time.ts b/specification/_types/Time.ts
index a957c95163..045566eab1 100644
--- a/specification/_types/Time.ts
+++ b/specification/_types/Time.ts
@@ -53,6 +53,7 @@ export type DateFormat = string
  * A duration. Units can be `nanos`, `micros`, `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours) and
  * `d` (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  * @doc_id time-value
+ * @ext_doc_id time-units
  */
 // Used to be Time, see ES TimeValue
 export type Duration = string | -1 | 0