@devvit/protos 0.12.7 → 0.12.8-next-2025-12-22-22-32-17-484c84a9e.0

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/modnote/modnote_msg.proto

@@ -0,0 +1,104 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.modnote;
+
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.modnote";
+
+// Requests
+message DeleteNotesRequest {
+  // subreddit name without the r/
+  string subreddit = 1;
+  // a unique ID for the note to be deleted (should have a ModNote_ prefix)
+  string note_id = 2;
+  // account username
+  string user = 3;
+}
+
+message GetNotesRequest {
+  // subreddit name without the r/
+  string subreddit = 1;
+  // (optional) an encoded string used for pagination with mod notes
+  google.protobuf.StringValue before = 2;
+  // (optional) one of (NOTE, APPROVAL, REMOVAL, BAN, MUTE, INVITE, SPAM, CONTENT_CHANGE,
+  // MOD_ACTION, ALL), to be used for querying specific types of mod notes (default: all)
+  google.protobuf.StringValue filter = 3;
+  // (optional) the number of mod notes to return in the response payload (default: 25, max: 100)
+  google.protobuf.Int64Value limit = 4;
+  // account username
+  string user = 5;
+}
+
+message PostNotesRequest {
+  string subreddit = 1;
+  // (optional) one of (BOT_BAN, PERMA_BAN, BAN, ABUSE_WARNING, SPAM_WARNING, SPAM_WATCH, SOLID_CONTRIBUTOR, HELPFUL_USER)
+  optional string label = 2;
+  // Content of the note, should be a string with a maximum character limit of 250
+  string note = 3;
+  // (optional) a fullname of a comment or post (should have either a t1 or t3 prefix)
+  google.protobuf.StringValue reddit_id = 4;
+  // account username
+  string user = 5;
+}
+
+message RecentNotesRequest {
+  // a comma delimited list of subreddits by name (e.g. 'pics,worldnews')
+  string subreddits = 1;
+  // a comma delimited list of usernames (e.g. 'foo,bar')
+  string users = 2;
+}
+
+message PostRemovalNoteRequest {
+  // list of thing ids
+  repeated string item_ids = 1;
+  // id of a Removal Reason - you can leave this as an empty string if you don't have one
+  string reason_id = 2;
+  // the reason for removal (maximum 100 characters)
+  google.protobuf.StringValue mod_note = 3;
+}
+
+// Responses
+message ModNotesResponse {
+  repeated ModNoteObject mod_notes = 1;
+  google.protobuf.StringValue start_cursor = 2;
+  google.protobuf.StringValue end_cursor = 3;
+  google.protobuf.BoolValue has_next_page = 4;
+}
+
+message DeleteNotesResponse {
+  google.protobuf.BoolValue deleted = 1;
+}
+
+message ModNoteObject {
+  message ModActionData {
+    google.protobuf.StringValue action = 1;
+    google.protobuf.StringValue reddit_id = 2;
+    google.protobuf.StringValue details = 3;
+    google.protobuf.StringValue description = 4;
+  }
+
+  message UserNoteData {
+    google.protobuf.StringValue note = 1;
+    google.protobuf.StringValue reddit_id = 2;
+    google.protobuf.StringValue label = 3;
+  }
+
+  google.protobuf.StringValue subreddit_id = 1;
+  google.protobuf.StringValue operator_id = 2;
+  ModActionData mod_action_data = 3;
+  UserNoteData user_note_data = 4;
+  google.protobuf.StringValue subreddit = 5;
+  google.protobuf.StringValue user = 6;
+  google.protobuf.StringValue operator = 7;
+  google.protobuf.StringValue id = 8;
+  google.protobuf.StringValue user_id = 9;
+  google.protobuf.Int64Value created_at = 10;
+  google.protobuf.StringValue cursor = 11;
+  google.protobuf.StringValue type = 12;
+}
+
+message PostModNotesResponse {
+  ModNoteObject created = 1;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/modnote/modnote_svc.proto

@@ -0,0 +1,45 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.modnote;
+
+import "devvit/plugin/redditapi/common/common_msg.proto";
+import "devvit/plugin/redditapi/modnote/modnote_msg.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.modnote";
+
+// MODNOTE - https://www.reddit.com/dev/api#section_modnote
+service ModNote {
+  // @see {@link https://www.reddit.com/dev/api#GET_api_mod_notes}
+  rpc GetNotes(GetNotesRequest) returns (ModNotesResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/notes?before={before}&filter={filter}&limit={limit}&subreddit={subreddit}&user={user}';
+  }
+
+  // @see {@link https://www.reddit.com/dev/api/#DELETE_api_mod_notes}
+  rpc DeleteNotes(DeleteNotesRequest) returns (DeleteNotesResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'DELETE';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/notes?note_id={note_id}&subreddit={subreddit}&user={user}';
+  }
+
+  // @see {@link https://www.reddit.com/dev/api#POST_api_mod_notes}
+  rpc PostNotes(PostNotesRequest) returns (PostModNotesResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/notes';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+  }
+
+  // Add a mod note for why a post or comment was removed
+  rpc PostRemovalNote(PostRemovalNoteRequest) returns (google.protobuf.Empty) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/v1/modactions/removal_reasons';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = JSON_SNAKE;
+  }
+
+  // @see {@link https://www.reddit.com/dev/api#GET_api_mod_notes_recent}
+  rpc RecentNotes(RecentNotesRequest) returns (ModNotesResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/notes/recent?subreddits={subreddits}&users={users}';
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/newmodmail/newmodmail_msg.proto

@@ -0,0 +1,348 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.newmodmail;
+
+import "google/protobuf/any.proto";
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.newmodmail";
+
+// Shared Objects
+message ConversationData {
+  message ObjId {
+    // Id of an object (e.g. message ID or modAction ID)
+    google.protobuf.StringValue id = 1;
+    // Property name of the object collection (e.g. 'messages' or 'modActions')
+    google.protobuf.StringValue key = 2;
+  }
+
+  message Owner {
+    // Subreddit display name
+    google.protobuf.StringValue display_name = 1;
+    // always 'subreddit'
+    google.protobuf.StringValue type = 2;
+    // Subreddit id
+    google.protobuf.StringValue id = 3;
+  }
+
+  // Is the conversation automatically generated e.g. from automod, u/reddit
+  google.protobuf.BoolValue is_auto = 1;
+  // Participant. Is absent for mod discussions
+  Participant participant = 2;
+  // List of object ids (denormalized). E.g. [{id: 'qwer42', key: 'messages'}, {id: 'abcd33', key: 'modActions'}]
+  repeated ObjId obj_ids = 3;
+  // NOTE: is_repliable will always be true currently (at the time of writing this comment)
+  google.protobuf.BoolValue is_repliable = 4;
+  // The last datetime a user made any interaction with the conversation
+  google.protobuf.StringValue last_user_update = 5;
+  // Is the conversation internal (i.e. mod only)
+  google.protobuf.BoolValue is_internal = 6;
+  // The last datetime a mod from the owning subreddit made any interaction with the conversation.
+  // (Note that if this is a subreddit to subreddit conversation, the mods of
+  // the participant subreddit are irrelevant and do not affect this field.)
+  google.protobuf.StringValue last_mod_update = 7;
+  repeated Participant authors = 8;
+  // The last time the conversation was updated (includes actions)
+  google.protobuf.StringValue last_updated = 9;
+  // Id of the first corresponding message in the legacy message system
+  google.protobuf.StringValue legacy_first_message_id = 10;
+  google.protobuf.Int32Value state = 11;
+  // Type of conversation:
+  // - `internal` (mod discussion)
+  // - `sr_user` (between a subreddit and user)
+  // - `sr_sr` (between two subreddits)
+  google.protobuf.StringValue conversation_type = 12;
+  // The datetime of the last unread message within this conversation for the current viewer.
+  google.protobuf.StringValue last_unread = 13;
+  // The subreddit that owns the conversation.
+  Owner owner = 14;
+  // Suject of the conversation
+  google.protobuf.StringValue subject = 15;
+  // Conversation ID
+  google.protobuf.StringValue id = 16;
+  // Is the conversation highlighted
+  google.protobuf.BoolValue is_highlighted = 17;
+  // Number of messages (not actions) in the conversation
+  google.protobuf.Int64Value num_messages = 18;
+
+  // from createconversationmessageresponse
+  map<string, ModActionData> mod_actions = 19;
+}
+
+message MessageData {
+  google.protobuf.StringValue body = 1;
+  Participant author = 2;
+  google.protobuf.BoolValue is_internal = 3;
+  google.protobuf.StringValue date = 4;
+  google.protobuf.StringValue body_markdown = 5;
+  google.protobuf.StringValue id = 6;
+  google.protobuf.StringValue participating_as = 7;
+}
+
+message ConversationUserData {
+  message CommentData {
+    google.protobuf.StringValue comment = 1;
+    google.protobuf.StringValue date = 2;
+    google.protobuf.StringValue permalink = 3;
+    google.protobuf.StringValue title = 4;
+  }
+  message MuteStatus {
+    google.protobuf.Int64Value mute_count = 1;
+    google.protobuf.BoolValue is_muted = 2;
+    google.protobuf.StringValue end_date = 3;
+    google.protobuf.StringValue reason = 4;
+  }
+  message BanStatus {
+    google.protobuf.BoolValue is_banned = 1;
+    google.protobuf.BoolValue is_permanent = 2;
+    google.protobuf.StringValue end_date = 3;
+    google.protobuf.StringValue reason = 4;
+  }
+  message ApproveStatus {
+    google.protobuf.BoolValue is_approved = 1;
+  }
+  message PostData {
+    google.protobuf.StringValue date = 1;
+    google.protobuf.StringValue permalink = 2;
+    google.protobuf.StringValue title = 3;
+  }
+  message ConvoData {
+    google.protobuf.StringValue date = 1;
+    google.protobuf.StringValue permalink = 2;
+    google.protobuf.StringValue id = 3;
+    google.protobuf.StringValue subject = 4;
+  }
+
+  map<string, CommentData> recent_comments = 1;
+  MuteStatus mute_status = 2;
+  google.protobuf.StringValue name = 3;
+  google.protobuf.StringValue created = 4;
+  BanStatus ban_status = 5;
+  google.protobuf.BoolValue is_suspended = 6;
+  ApproveStatus approve_status = 7;
+  google.protobuf.BoolValue is_shadow_banned = 8;
+  map<string, PostData> recent_posts = 9;
+  map<string, ConvoData> recent_convos = 10;
+  google.protobuf.StringValue id = 11;
+}
+
+message Participant {
+  google.protobuf.BoolValue is_mod = 1;
+  google.protobuf.BoolValue is_admin = 2;
+  google.protobuf.StringValue name = 3;
+  google.protobuf.BoolValue is_op = 4;
+  google.protobuf.BoolValue is_participant = 5;
+  google.protobuf.BoolValue is_approved = 6;
+  google.protobuf.BoolValue is_hidden = 7;
+  google.protobuf.Int64Value id = 8;
+  google.protobuf.BoolValue is_deleted = 9;
+}
+
+message ModActionData {
+  message ModActionAuthor {
+    google.protobuf.BoolValue is_mod = 1;
+    google.protobuf.BoolValue is_admin = 2;
+    google.protobuf.StringValue name = 3;
+    google.protobuf.BoolValue is_hidden = 4;
+    google.protobuf.Int64Value id = 5;
+    google.protobuf.BoolValue is_deleted = 6;
+  }
+
+  google.protobuf.StringValue date = 1;
+  google.protobuf.Int32Value action_type_id = 2;
+  google.protobuf.StringValue id = 3;
+  ModActionAuthor author = 4;
+}
+
+// Requests
+message BulkReadConversationsRequest {
+  // comma-delimited list of subreddit names (e.g. 'pics,worldnews'
+  string entity = 1;
+  // one of (all, appeals, notifications, inbox, filtered, inprogress, mod, archived, default,
+  // highlighted, join_requests, new)
+  string state = 2;
+}
+
+message GetConversationsRequest {
+  // id36 of a modmail
+  google.protobuf.StringValue after = 1;
+  // comma-delimited list of subreddit names
+  google.protobuf.StringValue entity = 2;
+  // an integer between 1 and 100 (default: 25)
+  google.protobuf.Int32Value limit = 3;
+  // one of (recent, mod, user, unread)
+  google.protobuf.StringValue sort = 4;
+  // one of (all, appeals, notifications, inbox, filtered, inprogress, mod, archived, default,
+  // highlighted, join_requests, new)
+  google.protobuf.StringValue state = 5;
+}
+
+message CreateConversationRequest {
+  // raw markdown text
+  string body = 1;
+  // is author hidden?
+  bool is_author_hidden = 2;
+  // subreddit name
+  string sr_name = 3;
+  // subject of the conversation. max 100 characters.
+  string subject = 4;
+  // a user (e.g. u/username), a subreddit (e.g. r/subreddit) or null
+  google.protobuf.StringValue to = 5;
+}
+
+message GetConversationRequest {
+  // id36 of a modmail conversation id
+  string conversation_id = 1;
+  // mark read?
+  bool mark_read = 2;
+}
+
+message CreateConversationMessageRequest {
+  // markdown text
+  string body = 1;
+  bool is_author_hidden = 2;
+  bool is_internal = 3;
+  // id36 of a modmail conversation id
+  string conversation_id = 4;
+}
+
+message BasicConversationRequest {
+  // id36 of a modmail conversation id
+  string conversation_id = 1;
+}
+
+message BasicConversationsRequest {
+  // comma seperated list of id36 of a modmail conversation ids
+  string conversation_ids = 1;
+}
+
+message MuteConversationRequest {
+  // id36 of a modmail conversation id
+  string conversation_id = 1;
+  // how long? one of (72, 168, 672)
+  int32 num_hours = 2;
+}
+
+message TempBanRequest {
+  // id36 of a modmail conversation id
+  string conversation_id = 1;
+  // duration in days, max 999
+  int32 duration = 2;
+}
+
+// Responses
+message BulkReadConversationsResponse {
+  repeated google.protobuf.StringValue conversation_ids = 1;
+}
+
+message GetConversationsResponse {
+  map<string, ConversationData> conversations = 1;
+  map<string, MessageData> messages = 2;
+  google.protobuf.StringValue viewer_id = 3;
+  repeated google.protobuf.StringValue conversation_ids = 4;
+}
+
+message CreateConversationResponse {
+  ConversationData conversation = 1;
+  map<string, MessageData> messages = 2;
+  map<string, ModActionData> mod_actions = 3;
+
+  // error case
+  repeated google.protobuf.StringValue fields = 4;
+  google.protobuf.StringValue reason = 5;
+  google.protobuf.StringValue message = 6;
+  google.protobuf.StringValue explanation = 7;
+
+  ConversationUserData user = 8;
+}
+
+message GetConversationResponse {
+  ConversationData conversation = 1;
+  map<string, MessageData> messages = 2;
+  map<string, ModActionData> mod_actions = 3;
+  google.protobuf.Any participant_subreddit = 4;
+  ConversationUserData user = 5;
+}
+
+message CreateConversationMessageResponse {
+  ConversationData conversation = 1;
+  map<string, MessageData> messages = 2;
+  ConversationUserData user = 3;
+}
+
+message ApproveConversationResponse {
+  ConversationData conversations = 1;
+  map<string, MessageData> messages = 2;
+  ConversationUserData user = 3;
+  map<string, ModActionData> mod_actions = 4;
+
+  // error case
+  repeated google.protobuf.StringValue fields = 5;
+  google.protobuf.StringValue reason = 6;
+  google.protobuf.StringValue message = 7;
+  google.protobuf.StringValue explanation = 8;
+}
+
+message ArchiveConversationResponse {
+  // @deprecated use `conversation`
+  ConversationData conversations = 1;
+  map<string, MessageData> messages = 2;
+  map<string, ModActionData> mod_actions = 3;
+  ConversationData conversation = 4;
+}
+
+message HighlightConversationResponse {
+  // @deprecated use `conversation`
+  ConversationData conversations = 1;
+  map<string, MessageData> messages = 2;
+  map<string, ModActionData> mod_actions = 3;
+  ConversationData conversation = 4;
+}
+
+message MuteConversationResponse {
+  ConversationData conversations = 1;
+  map<string, MessageData> messages = 2;
+  ConversationUserData user = 3;
+  map<string, ModActionData> mod_actions = 4;
+}
+
+message TempBanResponse {
+  ConversationData conversations = 1;
+  map<string, MessageData> messages = 2;
+  ConversationUserData user = 3;
+  map<string, ModActionData> mod_actions = 4;
+
+  // error case
+  repeated google.protobuf.StringValue fields = 5;
+  google.protobuf.StringValue reason = 6;
+  google.protobuf.StringValue message = 7;
+}
+
+message SubredditsResponse {
+  message SubredditData {
+    google.protobuf.StringValue community_icon = 1;
+    google.protobuf.StringValue key_color = 2;
+    google.protobuf.StringValue display_name = 3;
+    google.protobuf.StringValue name = 4;
+    google.protobuf.Int32Value subscribers = 5;
+    google.protobuf.StringValue primary_color = 6;
+    google.protobuf.StringValue id = 7;
+    google.protobuf.StringValue last_updated = 8;
+    google.protobuf.StringValue icon = 9;
+  }
+
+  map<string, SubredditData> subreddits = 1;
+}
+
+message UnreadCountResponse {
+  google.protobuf.Int32Value archived = 1;
+  google.protobuf.Int32Value appeals = 2;
+  google.protobuf.Int32Value highlighted = 3;
+  google.protobuf.Int32Value notifications = 4;
+  google.protobuf.Int32Value join_requests = 5;
+  google.protobuf.Int32Value filtered = 6;
+  google.protobuf.Int32Value new = 7;
+  google.protobuf.Int32Value inprogress = 8;
+  google.protobuf.Int32Value mod = 9;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/newmodmail/newmodmail_svc.proto

@@ -0,0 +1,142 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.newmodmail;
+
+import "devvit/plugin/redditapi/common/common_msg.proto";
+import "devvit/plugin/redditapi/newmodmail/newmodmail_msg.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.newmodmail";
+
+// NEWMODMAIL - https://www.reddit.com/dev/api#section_modmail
+service NewModmail {
+  // https://www.reddit.com/dev/api#POST_api_mod_bulk_read
+  rpc BulkReadConversations(BulkReadConversationsRequest) returns (BulkReadConversationsResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/bulk/read';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_mod_conversations
+  rpc GetConversations(GetConversationsRequest) returns (GetConversationsResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations?after={after}&entity={entity}&limit={limit}&sort={sort}&state={state}';
+    option (devvit.plugin.redditapi.common.api_client_config).use_custom_response_parser = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations
+  rpc CreateConversation(CreateConversationRequest) returns (CreateConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_mod_conversations_:conversation_id
+  rpc GetConversation(GetConversationRequest) returns (GetConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}?markRead={mark_read}';
+    option (devvit.plugin.redditapi.common.api_client_config).use_custom_response_parser = true;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id
+  rpc CreateConversationMessage(CreateConversationMessageRequest) returns (CreateConversationMessageResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_approve
+  rpc ApproveConversation(BasicConversationRequest) returns (ApproveConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/approve';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_archive
+  rpc ArchiveConversation(BasicConversationRequest) returns (ArchiveConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/archive';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_disapprove
+  rpc DisapproveConversation(BasicConversationRequest) returns (ApproveConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/disapprove';
+  }
+
+  // https://www.reddit.com/dev/api#DELETE_api_mod_conversations_:conversation_id_highlight
+  rpc UnhighlightConversation(BasicConversationRequest) returns (HighlightConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'DELETE';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/highlight';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_highlight
+  rpc HighlightConversation(BasicConversationRequest) returns (HighlightConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/highlight';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_mute
+  rpc MuteConversation(MuteConversationRequest) returns (MuteConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/mute';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_SNAKE;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_temp_ban
+  rpc TempBan(TempBanRequest) returns (TempBanResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/temp_ban';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = JSON_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_unarchive
+  rpc UnarchiveConversation(BasicConversationRequest) returns (ArchiveConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/unarchive';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_unban
+  rpc Unban(BasicConversationRequest) returns (TempBanResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/unban';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_:conversation_id_unmute
+  rpc UnmuteConversation(BasicConversationRequest) returns (MuteConversationResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/unmute';
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_mod_conversations_:conversation_id_user
+  rpc UserConversations(BasicConversationRequest) returns (ConversationUserData) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/{conversation_id}/user';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_read
+  rpc Read(BasicConversationsRequest) returns (google.protobuf.Empty) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/read';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_mod_conversations_subreddits
+  rpc Subreddits(google.protobuf.Empty) returns (SubredditsResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/subreddits';
+  }
+
+  // https://www.reddit.com/dev/api#POST_api_mod_conversations_unread
+  rpc Unread(BasicConversationsRequest) returns (google.protobuf.Empty) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'POST';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/unread';
+    option (devvit.plugin.redditapi.common.api_client_config).request_body_type = FORM_CAMEL;
+  }
+
+  // https://www.reddit.com/dev/api#GET_api_mod_conversations_unread_count
+  rpc UnreadCount(google.protobuf.Empty) returns (UnreadCountResponse) {
+    option (devvit.plugin.redditapi.common.api_client_config).method = 'GET';
+    option (devvit.plugin.redditapi.common.api_client_config).path = '/api/mod/conversations/unread/count';
+  }
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/plugin/redditapi/privatemessages/privatemessages_msg.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package devvit.plugin.redditapi.privatemessages;
+
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/plugin/redditapi";
+option java_package = "com.reddit.devvit.plugin.redditapi.privatemessages";
+
+message GenericPrivateMessagesRequest {
+  // fullname of a thing
+  string id = 1;
+}
+
+message ComposeRequest {
+  // the name of an existing user
+  string to = 1;
+  // a string no longer than 100 characters
+  string subject = 2;
+  // raw markdown text
+  string text = 3;
+  // subreddit name
+  string from_sr = 4; // TODO: Not required
+}
+
+message ReadAllMessagesRequest {
+  // A comma-separated list of items
+  string filter_types = 1;
+}
+
+message MessageWhereRequest {
+  // one "inbox", "unread", or "sent"
+  string where = 1;
+  // true or false
+  google.protobuf.BoolValue mark = 2;
+  // message id
+  google.protobuf.StringValue mid = 3;
+  // fullname of a thing
+  google.protobuf.StringValue after = 4;
+  // fullname of a thing
+  google.protobuf.StringValue before = 5;
+  // a positive integer (default: 0)
+  google.protobuf.Int64Value count = 6;
+  // the maximum number of items desired (default: 25, maximum: 100)
+  google.protobuf.Int64Value limit = 7;
+  // (optional) the string all
+  google.protobuf.StringValue show = 8;
+}