fix: manually specify params

crates/core/database/src/util/reference.rs

@@ -3,14 +3,6 @@ use std::str::FromStr;
 use revolt_result::Result;
 #[cfg(feature = "rocket-impl")]
 use rocket::request::FromParam;
-#[cfg(feature = "utoipa")]
-use utoipa::{
-    openapi::{
-        path::{Parameter, ParameterBuilder, ParameterIn},
-        Required,
-    },
-    IntoParams,
-};
 
 use crate::{
     Bot, Channel, Database, Emoji, Invite, Member, Message, Server, ServerBan, User, Webhook,
@@ -115,15 +107,3 @@ impl<'r> FromParam<'r> for Reference<'r> {
         Ok(Reference::from_unchecked(param))
     }
 }
-
-#[cfg(feature = "utoipa")]
-impl IntoParams for Reference<'_> {
-    fn into_params(parameter_in_provider: impl Fn() -> Option<ParameterIn>) -> Vec<Parameter> {
-        vec![ParameterBuilder::new()
-            .name("id")
-            .required(Required::True)
-            .description(Some("An ID".to_string()))
-            .parameter_in(parameter_in_provider().unwrap_or_default())
-            .build()]
-    }
-}

crates/core/database/src/util/utoipa.rs

@@ -1,4 +1,13 @@
-use utoipa::{Modify, openapi::{OpenApi, security::{ApiKey, ApiKeyValue, SecurityScheme}}};
+use utoipa::{
+    openapi::{
+        schema::SchemaType,
+        security::{ApiKey, ApiKeyValue, SecurityScheme},
+        ObjectBuilder, OpenApi, RefOr, Schema, Type,
+    },
+    Modify, PartialSchema, ToSchema,
+};
+
+use crate::util::reference::Reference;
 
 pub struct TokenSecurity;
 
@@ -18,4 +27,23 @@ impl Modify for TokenSecurity {
             SecurityScheme::ApiKey(ApiKey::Header(ApiKeyValue::new("X-Bot-Ticket".to_string()))),
         );
     }
-}
+}
+
+impl ToSchema for Reference<'_> {
+    fn name() -> std::borrow::Cow<'static, str> {
+        std::borrow::Cow::Borrowed("Reference")
+    }
+}
+
+impl PartialSchema for Reference<'_> {
+    fn schema() -> RefOr<Schema> {
+        RefOr::T(
+            ObjectBuilder::new()
+                .description(Some("An id referencing a stoat model."))
+                .schema_type(SchemaType::Type(Type::String))
+                .examples(["01FD58YK5W7QRV5H3D64KTQYX3"])
+                .build()
+                .into(),
+        )
+    }
+}

crates/delta/src/routes/channels/channel_ack.rs

@@ -13,6 +13,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("message" = Reference, Path),
+    ),
     responses(
         (status = 204)
     )

crates/delta/src/routes/channels/channel_delete.rs

@@ -15,7 +15,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Channel Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsChannelDelete),
+    params(
+        ("target" = Reference, Path),
+        v0::OptionsChannelDelete,
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/channel_edit.rs

@@ -15,6 +15,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Channel Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/channels/channel_fetch.rs

@@ -14,6 +14,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Channel Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/channels/group_add_member.rs

@@ -14,6 +14,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Groups",
     security(("Session-Token" = [])),
+    params(
+        ("group_id" = Reference, Path),
+        ("member_id" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/group_remove_member.rs

@@ -15,6 +15,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Groups",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("member" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/invite_create.rs

@@ -16,6 +16,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Channel Invites",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Invite),
     ),

crates/delta/src/routes/channels/members_fetch.rs

@@ -15,6 +15,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Groups",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Vec<v0::User>),
     ),

crates/delta/src/routes/channels/message_bulk_delete.rs

@@ -20,6 +20,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_clear_reactions.rs

@@ -15,6 +15,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Interactions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_delete.rs

@@ -13,6 +13,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_edit.rs

@@ -16,6 +16,10 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Message),
     ),

crates/delta/src/routes/channels/message_fetch.rs

@@ -13,6 +13,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Message),
     ),

crates/delta/src/routes/channels/message_pin.rs

@@ -14,6 +14,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_query.rs

@@ -14,7 +14,10 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsQueryMessages),
+    params(
+        ("target" = Reference, Path),
+        v0::OptionsQueryMessages,
+    ),
     responses(
         (status = 200, body = v0::BulkMessageResponse),
     ),

crates/delta/src/routes/channels/message_react.rs

@@ -13,6 +13,11 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Interactions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+        ("emoji" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_search.rs

@@ -14,6 +14,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::BulkMessageResponse),
     ),

crates/delta/src/routes/channels/message_send.rs

@@ -19,6 +19,9 @@ use validator::Validate;
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
     params(IdempotencyKey),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Message),
     ),

crates/delta/src/routes/channels/message_unpin.rs

@@ -14,6 +14,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/message_unreact.rs

@@ -16,7 +16,12 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Interactions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsUnreact),
+    params(
+        ("target" = Reference, Path),
+        ("msg" = Reference, Path),
+        ("emoji" = Reference, Path),
+        v0::OptionsUnreact,
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/permissions_set.rs

@@ -14,6 +14,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Channel Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("role_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/channels/permissions_set_default.rs

@@ -14,6 +14,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Channel Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/channels/voice_join.rs

@@ -19,6 +19,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Voice",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::DataJoinCall),
     ),

crates/delta/src/routes/channels/voice_stop_ring.rs

@@ -17,6 +17,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Voice",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("target_user." = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/channels/webhook_create.rs

@@ -17,6 +17,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Webhooks",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Webhook),
     ),

crates/delta/src/routes/channels/webhook_fetch_all.rs

@@ -13,6 +13,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Webhooks",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Vec<Webhook>),
     ),

crates/delta/src/routes/customisation/emoji_create.rs

@@ -1,5 +1,5 @@
 use revolt_config::config;
-use revolt_database::{util::permissions::DatabasePermissionQuery, Database, Emoji, File, User};
+use revolt_database::{Database, Emoji, File, User, util::{permissions::DatabasePermissionQuery, reference::Reference}};
 use revolt_models::v0;
 use revolt_permissions::{calculate_server_permissions, ChannelPermission};
 use revolt_result::{create_error, Result};
@@ -13,6 +13,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Emojis",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Emoji),
     ),

crates/delta/src/routes/customisation/emoji_delete.rs

@@ -14,6 +14,9 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Emojis",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("emoji_id" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/customisation/emoji_fetch.rs

@@ -10,6 +10,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Emojis",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("emoji_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Emoji),
     ),

crates/delta/src/routes/invites/invite_delete.rs

@@ -13,6 +13,9 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Invites",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/invites/invite_fetch.rs

@@ -9,6 +9,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Invites",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::InviteResponse),
     ),

crates/delta/src/routes/invites/invite_join.rs

@@ -9,6 +9,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Invites",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::InviteJoinResponse),
     ),

crates/delta/src/routes/mod.rs

@@ -1,5 +1,5 @@
 use revolt_config::Settings;
-use revolt_database::util::utoipa::TokenSecurity;
+use revolt_database::util::{utoipa::TokenSecurity, reference::Reference};
 use revolt_result::ErrorAddon;
 pub use rocket::http::Status;
 pub use rocket::response::Redirect;
@@ -235,6 +235,11 @@ pub fn mount(config: Settings, mut rocket: Rocket<Build>) -> Rocket<Build> {
         ),
 
     ),
+    components(
+        schemas(
+            Reference,
+        )
+    ),
     modifiers(
         &Extensions,
 

crates/delta/src/routes/servers/ban_create.rs

@@ -16,6 +16,10 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("server" = Reference, Path),
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::ServerBan),
     ),

crates/delta/src/routes/servers/ban_list.rs

@@ -15,6 +15,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::BanListResult),
     ),

crates/delta/src/routes/servers/ban_remove.rs

@@ -13,6 +13,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("server" = Reference, Path),
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/servers/channel_create.rs

@@ -14,6 +14,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("server" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/servers/emoji_list.rs

@@ -13,6 +13,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Customisation",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Vec<v0::Emoji>),
     ),

crates/delta/src/routes/servers/invites_fetch.rs

@@ -13,6 +13,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Vec<v0::Invite>),
     ),

crates/delta/src/routes/servers/member_edit.rs

@@ -28,6 +28,10 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("server" = Reference, Path),
+        ("member" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Member),
     ),

crates/delta/src/routes/servers/member_experimental_query.rs

@@ -34,7 +34,10 @@ pub struct MemberQueryResponse {
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(OptionsQueryMembers),
+    params(
+        ("target" = Reference, Path),
+        OptionsQueryMembers,
+    ),
     responses(
         (status = 200, body = MemberQueryResponse),
     ),

crates/delta/src/routes/servers/member_fetch.rs

@@ -14,6 +14,8 @@ use rocket::{serde::json::Json, State};
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
     params(
+        ("target" = Reference, Path),
+        ("member" = Reference, Path),
         (
             "roles" = bool,
             Query,

crates/delta/src/routes/servers/member_fetch_all.rs

@@ -13,7 +13,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsFetchAllMembers),
+    params(
+        ("target" = Reference, Path),
+        v0::OptionsFetchAllMembers
+    ),
     responses(
         (status = 200, body = v0::AllMemberResponse),
     ),

crates/delta/src/routes/servers/member_remove.rs

@@ -14,6 +14,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Server Members",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("member" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/servers/permissions_set.rs

@@ -14,6 +14,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("role_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Server),
     ),

crates/delta/src/routes/servers/permissions_set_default.rs

@@ -14,6 +14,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Server),
     ),

crates/delta/src/routes/servers/roles_create.rs

@@ -15,6 +15,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::NewRoleResponse),
     ),

crates/delta/src/routes/servers/roles_delete.rs

@@ -14,6 +14,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("role_id" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/servers/roles_edit.rs

@@ -15,6 +15,10 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("role_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Role),
     ),

crates/delta/src/routes/servers/roles_edit_positions.rs

@@ -12,6 +12,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Server),
     ),

crates/delta/src/routes/servers/roles_fetch.rs

@@ -13,6 +13,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+        ("role_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Role),
     ),

crates/delta/src/routes/servers/server_ack.rs

@@ -13,6 +13,9 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/servers/server_delete.rs

@@ -18,7 +18,10 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Server Permissions",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsServerDelete),
+    params(
+        ("target" = Reference, Path),
+        v0::OptionsServerDelete,
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/servers/server_edit.rs

@@ -16,6 +16,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Server Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Server),
     ),

crates/delta/src/routes/servers/server_fetch.rs

@@ -13,7 +13,10 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Server Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
-    params(v0::OptionsFetchServer),
+    params(
+        ("target" = Reference, Path),
+        v0::OptionsFetchServer
+    ),
     responses(
         (status = 200, body = v0::Server),
     ),

crates/delta/src/routes/users/add_friend.rs

@@ -11,6 +11,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "Relationships",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/users/block_user.rs

@@ -11,6 +11,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "Relationships",
     security(("Session-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/users/edit_user.rs

@@ -12,6 +12,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "User Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/users/fetch_profile.rs

@@ -15,6 +15,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "User Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::UserProfile),
     ),

crates/delta/src/routes/users/fetch_user.rs

@@ -14,6 +14,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "User Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path)
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/users/fetch_user_flags.rs

@@ -8,6 +8,9 @@ use rocket::{serde::json::Json, State};
 /// Retrieve a user's flags.
 #[utoipa::path(
     tag = "User Information",
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::FlagResponse),
     ),

crates/delta/src/routes/users/find_mutual.rs

@@ -14,6 +14,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "User Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::MutualResponse),
     ),

crates/delta/src/routes/users/get_default_avatar.rs

@@ -1,3 +1,4 @@
+use revolt_database::util::reference::Reference;
 use rocket::http::ContentType;
 use rocket::response::{self, Responder};
 use rocket::{Request, Response};
@@ -22,6 +23,9 @@ impl<'r> Responder<'r, 'static> for CachedFile {
 #[utoipa::path(
     tag = "User Information",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (
             status = 200,

crates/delta/src/routes/users/open_dm.rs

@@ -15,6 +15,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Direct Messaging",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::Channel),
     ),

crates/delta/src/routes/users/remove_friend.rs

@@ -11,6 +11,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "Relationships",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/users/unblock_user.rs

@@ -11,6 +11,9 @@ use rocket::State;
 #[utoipa::path(
     tag = "Relationships",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("target" = Reference, Path),
+    ),
     responses(
         (status = 200, body = v0::User),
     ),

crates/delta/src/routes/webhooks/webhook_delete.rs

@@ -13,6 +13,9 @@ use rocket_empty::EmptyResponse;
 #[utoipa::path(
     tag = "Webhooks",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("webhook_id" = Reference, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/webhooks/webhook_delete_token.rs

@@ -8,6 +8,10 @@ use rocket_empty::EmptyResponse;
 /// Deletes a webhook with a token
 #[utoipa::path(
     tag = "Webhooks",
+    params(
+        ("webhook_id" = Reference, Path),
+        ("token" = String, Path),
+    ),
     responses(
         (status = 204),
     ),

crates/delta/src/routes/webhooks/webhook_edit.rs

@@ -14,6 +14,9 @@ use validator::Validate;
 #[utoipa::path(
     tag = "Webhooks",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("webhook_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Webhook),
     ),

crates/delta/src/routes/webhooks/webhook_edit_token.rs

@@ -10,6 +10,10 @@ use rocket::{serde::json::Json, State};
 /// Edits a webhook with a token
 #[utoipa::path(
     tag = "Webhooks",
+    params(
+        ("webhook_id" = Reference, Path),
+        ("token" = String, Path),
+    ),
     responses(
         (status = 200, body = Webhook),
     ),

crates/delta/src/routes/webhooks/webhook_execute.rs

@@ -15,7 +15,11 @@ use validator::Validate;
 /// Executes a webhook and sends a message
 #[utoipa::path(
     tag = "Webhooks",
-    params(IdempotencyKey),
+    params(
+        ("webhook_id" = Reference, Path),
+        ("token" = String, Path),
+        IdempotencyKey,
+    ),
     responses(
         (status = 200, body = v0::Message)
     )

crates/delta/src/routes/webhooks/webhook_execute_github.rs

@@ -713,7 +713,16 @@ fn convert_event(data: &str, event_name: &str) -> Result<Event> {
 /// Executes a webhook specific to github and sends a message containing the relevant info about the event
 #[utoipa::path(
     tag = "Webhooks",
-    params(EventHeader)
+    request_body(
+        content = String,
+        content_type = "application/json",
+        description = "Github event payload",
+    ),
+    params(
+        ("webhook_id" = Reference, Path),
+        ("token" = String, Path),
+        EventHeader,
+    ),
 )]
 #[post("/<webhook_id>/<token>/github", data = "<data>")]
 pub async fn webhook_execute_github(

crates/delta/src/routes/webhooks/webhook_fetch.rs

@@ -13,6 +13,9 @@ use rocket::{serde::json::Json, State};
 #[utoipa::path(
     tag = "Webhooks",
     security(("Session-Token" = []), ("Bot-Token" = [])),
+    params(
+        ("webhook_id" = Reference, Path),
+    ),
     responses(
         (status = 200, body = Webhook),
     ),

crates/delta/src/routes/webhooks/webhook_fetch_token.rs

@@ -8,6 +8,10 @@ use rocket::{serde::json::Json, State};
 /// Gets a webhook with a token
 #[utoipa::path(
     tag = "Webhooks",
+    params(
+        ("webhook_id" = Reference, Path),
+        ("token" = String, Path),
+    ),
     responses(
         (status = 200, body = Webhook),
     ),