Merge pull request #41 from glideapps/api-update-glide-pr-33138

OpenAPI spec update from glideapps/glide#33138

Author: chkn

api-reference/v2/resources/changelog.mdx

@@ -3,6 +3,11 @@ title: Glide API Changelog
 sidebarTitle: Changelog
 ---
 
+### April 1, 2025
+
+- Clarified that the version supplied in the `If-Match` header is compared against the row version, not the table version, in the Update Row endpoint.
+- Added HTTP 412 Precondition Failed as a possible error for endpoints that accept an `If-Match` header.
+
 ### December 13, 2024
 
 - Clarified that endpoints return row IDs in the same order as the input rows.

openapi/swagger.json

@@ -609,6 +609,41 @@
               }
             }
           },
+          "412": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string",
+                          "enum": [
+                            "precondition_failed"
+                          ]
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "type",
+                        "message"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
           "422": {
             "description": "",
             "content": {
@@ -655,7 +690,7 @@
             "schema": {
               "type": "string",
               "pattern": "^\"[0-9]+\"$",
-              "description": "ETag of the current table version. If provided, the request will fail if the table has been updated since this version."
+              "description": "ETag of the current table version. If provided, the request will fail if the table has been updated since the given version. See [Data Versioning](/api-reference/v2/tables/versioning)."
             },
             "required": false
           },
@@ -1449,6 +1484,41 @@
               }
             }
           },
+          "412": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string",
+                          "enum": [
+                            "precondition_failed"
+                          ]
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "type",
+                        "message"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
           "422": {
             "description": "",
             "content": {
@@ -1494,7 +1564,7 @@
             "schema": {
               "type": "string",
               "pattern": "^\"[0-9]+\"$",
-              "description": "ETag of the current table version. If provided, the request will fail if the table has been updated since this version."
+              "description": "ETag of the current table version. If provided, the request will fail if this row has been updated since the given version. See [Data Versioning](/api-reference/v2/tables/versioning)."
             },
             "required": false
           },