From 6c1dad958ae8ff01d2128ce0bf42ca565e6f849a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maximilian=20K=C3=B6stler?= <maximilian@koestler.dev>
Date: Mon, 18 Dec 2023 17:59:01 +0100
Subject: [PATCH] Doc: Fix descriptions for resource IDs

---
 openapi/hcloud.json                     | 20 ++++-----
 resources/document_transformations.json | 57 +++++++++++++++++++++++++
 2 files changed, 67 insertions(+), 10 deletions(-)

diff --git a/openapi/hcloud.json b/openapi/hcloud.json
index 4984e97..f1b4848 100644
--- a/openapi/hcloud.json
+++ b/openapi/hcloud.json
@@ -6,7 +6,7 @@
     "contact": {
       "url": "https://docs.hetzner.cloud/"
     },
-    "version": "4053943-dirty"
+    "version": "d4b9ef2-dirty"
   },
   "servers": [
     {
@@ -7658,16 +7658,16 @@
         "description": "Returns all Action objects for a Certificate. You can sort the results by using the `sort` URI parameter, and filter them with the `status` parameter.\n\nOnly type `managed` Certificates can have Actions. For type `uploaded` Certificates the `actions` key will always contain an empty array.\n",
         "parameters": [
           {
-            "description": "ID of the Action.",
+            "description": "ID of the Certificate",
             "in": "path",
             "name": "id",
             "required": true,
             "schema": {
-              "description": "ID of the Action. Limited to 52 bits to ensure compatability with JSON double precision floats.",
+              "description": "ID of the Certificate. Limited to 52 bits to ensure compatability with JSON double precision floats.",
               "example": 42,
               "format": "int64",
               "maximum": 9007199254740991,
-              "title": "Action ID",
+              "title": "Certificate ID",
               "type": "integer"
             }
           },
@@ -8398,16 +8398,16 @@
         "description": "Returns all Action objects for a Firewall. You can sort the results by using the `sort` URI parameter, and filter them with the `status` parameter.",
         "parameters": [
           {
-            "description": "ID of the Action.",
+            "description": "ID of the Firewall",
             "in": "path",
             "name": "id",
             "required": true,
             "schema": {
-              "description": "ID of the Action. Limited to 52 bits to ensure compatability with JSON double precision floats.",
+              "description": "ID of the Firewall. Limited to 52 bits to ensure compatability with JSON double precision floats.",
               "example": 42,
               "format": "int64",
               "maximum": 9007199254740991,
-              "title": "Action ID",
+              "title": "Firewall ID",
               "type": "integer"
             }
           },
@@ -15041,16 +15041,16 @@
         "description": "Returns all Action objects for a Server. You can `sort` the results by using the sort URI parameter, and filter them with the `status` parameter.",
         "parameters": [
           {
-            "description": "ID of the Action.",
+            "description": "ID of the Server",
             "in": "path",
             "name": "id",
             "required": true,
             "schema": {
-              "description": "ID of the Action. Limited to 52 bits to ensure compatability with JSON double precision floats.",
+              "description": "ID of the Server. Limited to 52 bits to ensure compatability with JSON double precision floats.",
               "example": 42,
               "format": "int64",
               "maximum": 9007199254740991,
-              "title": "Action ID",
+              "title": "Server ID",
               "type": "integer"
             }
           },
diff --git a/resources/document_transformations.json b/resources/document_transformations.json
index ec1317b..6200fd4 100644
--- a/resources/document_transformations.json
+++ b/resources/document_transformations.json
@@ -249,5 +249,62 @@
     "set": {
       "description": "ID of the Action"
     }
+  },
+
+  {
+    "path": ["paths", "/firewalls/{id}/actions", "get", "parameters", 0],
+    "set": {
+      "description": "ID of the Firewall"
+    }
+  },
+  {
+    "path": ["paths", "/firewalls/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "description": "ID of the Firewall. Limited to 52 bits to ensure compatability with JSON double precision floats."
+    }
+  },
+  {
+    "path": ["paths", "/firewalls/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "title": "Firewall ID"
+    }
+  },
+
+  {
+    "path": ["paths", "/certificates/{id}/actions", "get", "parameters", 0],
+    "set": {
+      "description": "ID of the Certificate"
+    }
+  },
+  {
+    "path": ["paths", "/certificates/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "description": "ID of the Certificate. Limited to 52 bits to ensure compatability with JSON double precision floats."
+    }
+  },
+  {
+    "path": ["paths", "/certificates/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "title": "Certificate ID"
+    }
+  },
+
+  {
+    "path": ["paths", "/servers/{id}/actions", "get", "parameters", 0],
+    "set": {
+      "description": "ID of the Server"
+    }
+  },
+  {
+    "path": ["paths", "/servers/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "description": "ID of the Server. Limited to 52 bits to ensure compatability with JSON double precision floats."
+    }
+  },
+  {
+    "path": ["paths", "/servers/{id}/actions", "get", "parameters", 0, "schema"],
+    "set": {
+      "title": "Server ID"
+    }
   }
 ]