Syncing protocol buffers

GitOrigin-RevId: ae71a5cbc4f9859c253108755bce371c202a19fe

wgtwo/annotations/annotations.proto

@@ -9,16 +9,38 @@ option java_package = "com.wgtwo.api.annotations";
 option java_outer_classname = "AnnotationsProto";
 
 extend google.protobuf.MethodOptions {
+  // Specifies the required access scope for this method.
   string scope = 50013;
 }
 
+// Enum representing the release status of API methods.
+//
+// More guidance around release status can be found in the
+// [API Lifecycle documentation](https://developer.cisco.com/docs/mobility-services/api-lifecycle/).
 enum ReleaseStatus {
+  // Default status when unspecified.
   UNSPECIFIED = 0;
+
+  // Indicates a stable method, suitable for production use.
+  // No breaking changes will be made to this method.
   STABLE = 1;
+
+  // Indicates a beta method, suitable for initial development and testing.
+  // Note that breaking changes may occur without notice.
+  //
+  // Most new methods will be released as beta, awaiting feedback from developers.
   BETA = 2;
+
+  // Indicates a deprecated method.
+  // It is recommended to migrate to newer alternatives if available.
+  //
+  // Please consult the
+  // [Cisco DevNet Mobility Services API documentation](https://docs.mobility.cisco.com/)
+  // for guidance.
   DEPRECATED = 3;
 }
 
 extend google.protobuf.MethodOptions {
+  // The release status of the method.
   ReleaseStatus status = 50015;
 }

wgtwo/annotations/buf.md

@@ -0,0 +1,7 @@
+## Annotations
+
+The annotations in the `wgtwo` package provide critical metadata for API methods.
+
+They are intended to aid developers in understanding the access scope required to use the API method.
+
+It also provides information about the API method's stability and deprecation status.

wgtwo/consents/v0/consents.proto

@@ -21,6 +21,7 @@ import "wgtwo/annotations/annotations.proto";
 import "wgtwo/common/v0/errors.proto";
 import "wgtwo/common/v0/phonenumber.proto";
 import "wgtwo/common/v0/types.proto";
+import "proto/wg2/types/pagination.proto";
 
 option go_package = "github.com/working-group-two/wgtwoapis/wgtwo/consents/v0";
 option java_package = "com.wgtwo.api.v0.consent";
@@ -46,6 +47,19 @@ service ConsentService {
     option (scope) = "subscription.consent:write";
   }
 
+  rpc ListConsentsForProduct (ListConsentsForProductRequest)
+      returns (ListConsentsForProductResponse) {
+    option (scope) = "";
+  }
+}
+
+message ListConsentsForProductRequest {
+  wg2.types.PaginationRequest pagination = 1;
+}
+
+message ListConsentsForProductResponse {
+  repeated Consent consents = 1;
+  wg2.types.PaginationResponse pagination = 2;
 }
 
 // Request to get consents for a subscription.
@@ -115,7 +129,7 @@ message Consent {
   // The scopes of the consent.
   repeated Scope scopes = 3;
   // Whether the consent is revocable.
-  bool revokable = 4;
+  bool revocable = 4;
   map<string, string> metadata = 5;
 }