docs: recommend gov_action_id variant for proposal metadata

blockfrost-openapi.yaml

@@ -1516,7 +1516,10 @@ paths:
       tags:
         - Cardano » Governance
       summary: Specific proposal metadata
-      description: Proposal metadata information.
+      description: |
+        Proposal metadata information.
+
+        If this endpoint returns `404` or empty metadata for a known proposal, the off-chain metadata could not be fetched (e.g. unreachable URL or hash mismatch). Use the [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata) variant instead — it always returns the anchor `url` and `hash` along with an `error` object describing the fetch failure, so you can retrieve the metadata manually if needed.
       parameters:
         - in: path
           name: tx_hash

docs/blockfrost-openapi.yaml

@@ -1644,7 +1644,17 @@ paths:
       tags:
         - Cardano » Governance
       summary: Specific proposal metadata
-      description: Proposal metadata information.
+      description: >
+        Proposal metadata information.
+
+
+        If this endpoint returns `404` or empty metadata for a known proposal,
+        the off-chain metadata could not be fetched (e.g. unreachable URL or
+        hash mismatch). Use the
+        [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata)
+        variant instead — it always returns the anchor `url` and `hash` along
+        with an `error` object describing the fetch failure, so you can retrieve
+        the metadata manually if needed.
       parameters:
         - in: path
           name: tx_hash

openapi.json

@@ -1878,7 +1878,7 @@
           "Cardano » Governance"
         ],
         "summary": "Specific proposal metadata",
-        "description": "Proposal metadata information.",
+        "description": "Proposal metadata information.\n\nIf this endpoint returns `404` or empty metadata for a known proposal, the off-chain metadata could not be fetched (e.g. unreachable URL or hash mismatch). Use the [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata) variant instead — it always returns the anchor `url` and `hash` along with an `error` object describing the fetch failure, so you can retrieve the metadata manually if needed.\n",
         "parameters": [
           {
             "in": "path",

openapi.yaml

@@ -1644,7 +1644,17 @@ paths:
       tags:
         - Cardano » Governance
       summary: Specific proposal metadata
-      description: Proposal metadata information.
+      description: >
+        Proposal metadata information.
+
+
+        If this endpoint returns `404` or empty metadata for a known proposal,
+        the off-chain metadata could not be fetched (e.g. unreachable URL or
+        hash mismatch). Use the
+        [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata)
+        variant instead — it always returns the anchor `url` and `hash` along
+        with an `error` object describing the fetch failure, so you can retrieve
+        the metadata manually if needed.
       parameters:
         - in: path
           name: tx_hash

src/generated-types.ts

@@ -1443,6 +1443,9 @@ export interface paths {
         /**
          * Specific proposal metadata
          * @description Proposal metadata information.
+         *
+         *     If this endpoint returns `404` or empty metadata for a known proposal, the off-chain metadata could not be fetched (e.g. unreachable URL or hash mismatch). Use the [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata) variant instead — it always returns the anchor `url` and `hash` along with an `error` object describing the fetch failure, so you can retrieve the metadata manually if needed.
+         *
          */
         get: {
             parameters: {

src/paths/api/governance/proposals/{tx_hash}/{cert_index}/metadata.yaml

@@ -2,7 +2,10 @@ get:
   tags:
     - Cardano » Governance
   summary: Specific proposal metadata
-  description: Proposal metadata information.
+  description: |
+    Proposal metadata information.
+
+    If this endpoint returns `404` or empty metadata for a known proposal, the off-chain metadata could not be fetched (e.g. unreachable URL or hash mismatch). Use the [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata) variant instead — it always returns the anchor `url` and `hash` along with an `error` object describing the fetch failure, so you can retrieve the metadata manually if needed.
   parameters:
     - in: path
       name: tx_hash