Merge pull request #38040 from cpuguy83/document_service_version

Add more API doc details on service update version.
2018-10-16 09:45:35 -07:00 · 2018-10-16 09:45:35 -07:00 · 5271c7cb48
commit 5271c7cb48
parent 4c3926a997 5bdfa19b86
1 changed files with 4 additions and 1 deletions
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@ -9360,7 +9360,10 @@ paths:

        - name: "version"
          in: "query"
-          description: "The version number of the service object being updated. This is required to avoid conflicting writes."
+          description: "The version number of the service object being updated.
+          This is required to avoid conflicting writes.
+          This version number should be the value as currently set on the service *before* the update.
+          You can find the current version by calling `GET /services/{id}`"
          required: true
          type: "integer"
        - name: "registryAuthFrom"