Merge pull request #169 from authzed/add-zedtoken-to-download-api

vroldanbet · web-flow · commit d5fc38fe34ec · 2026-05-21T19:02:18.000+01:00
api(materialize/v0): add at_revision zedtoken to DownloadPermissionSetsResponse
diff --git a/authzed/api/materialize/v0/watchpermissionsets.proto b/authzed/api/materialize/v0/watchpermissionsets.proto
@@ -217,4 +217,10 @@ message DownloadPermissionSetsResponse {
 
   // timestamp represents the time associated with the returned data revision.
   google.protobuf.Timestamp timestamp = 2;
+
+  // at_revision is the snapshot revision the returned files were produced at,
+  // encoded as a ZedToken. Consumers should pass this token to
+  // WatchPermissionSets as optional_starting_after to resume the stream
+  // immediately after the snapshot without leaving gaps in event history.
+  authzed.api.v1.ZedToken at_revision = 3;
 }
diff --git a/docs/apidocs.swagger.json b/docs/apidocs.swagger.json
@@ -1642,6 +1642,10 @@
           "type": "string",
           "format": "date-time",
           "description": "timestamp represents the time associated with the returned data revision."
+        },
+        "atRevision": {
+          "$ref": "#/definitions/ZedToken",
+          "description": "at_revision is the snapshot revision the returned files were produced at,\nencoded as a ZedToken. Consumers should pass this token to\nWatchPermissionSets as optional_starting_after to resume the stream\nimmediately after the snapshot without leaving gaps in event history."
         }
       }
     },

Original file line number	Diff line number	Diff line change
`@@ -1642,6 +1642,10 @@`
`1642`	`1642`	`"type": "string",`
`1643`	`1643`	`"format": "date-time",`
`1644`	`1644`	`"description": "timestamp represents the time associated with the returned data revision."`
	`1645`	`+ },`
	`1646`	`+ "atRevision": {`
	`1647`	`+ "$ref": "#/definitions/ZedToken",`
	`1648`	`+ "description": "at_revision is the snapshot revision the returned files were produced at,\nencoded as a ZedToken. Consumers should pass this token to\nWatchPermissionSets as optional_starting_after to resume the stream\nimmediately after the snapshot without leaving gaps in event history."`
`1645`	`1649`	`}`
`1646`	`1650`	`}`
`1647`	`1651`	`},`