cleanup

backend/src/routes/profile.rs

@@ -57,6 +57,12 @@ pub struct RevokePasskeyQuery {
     pub reason: Option<String>,
 }
 
+#[utoipa::path(
+    get,
+    path = "/api/profile/passkeys",
+    responses((status = 200, description = "List registered passkeys", body = [PasskeySummary])),
+    tag = "Profile"
+)]
 pub async fn list_passkeys(
     State(state): State<AppState>,
     TenantScopedConn {
@@ -72,6 +78,12 @@ pub async fn list_passkeys(
     Ok(Json(passkeys))
 }
 
+#[utoipa::path(
+    get,
+    path = "/api/profile/webdav-tokens",
+    responses((status = 200, description = "List WebDAV tokens", body = [WebdavTokenResponse])),
+    tag = "Profile"
+)]
 pub async fn list_webdav_tokens(
     TenantScopedConn {
         mut conn,
@@ -85,6 +97,13 @@ pub async fn list_webdav_tokens(
     Ok(Json(responses))
 }
 
+#[utoipa::path(
+    post,
+    path = "/api/profile/webdav-tokens",
+    request_body = CreateWebdavTokenRequest,
+    responses((status = 201, description = "WebDAV token created", body = WebdavTokenCreatedResponse)),
+    tag = "Profile"
+)]
 pub async fn create_webdav_token(
     TenantScopedConn {
         mut conn,
@@ -115,6 +134,13 @@ pub async fn create_webdav_token(
     Ok((StatusCode::CREATED, Json(response)))
 }
 
+#[utoipa::path(
+    delete,
+    path = "/api/profile/webdav-tokens/{id}",
+    params(("id" = Uuid, Path, description = "WebDAV token ID")),
+    responses((status = 204, description = "WebDAV token revoked")),
+    tag = "Profile"
+)]
 pub async fn delete_webdav_token(
     TenantScopedConn {
         mut conn, user_id, ..
@@ -125,6 +151,16 @@ pub async fn delete_webdav_token(
     no_content()
 }
 
+#[utoipa::path(
+    delete,
+    path = "/api/profile/passkeys/{id}",
+    params(
+        ("id" = Uuid, Path, description = "Passkey ID"),
+        ("reason" = Option<String>, Query, description = "Optional reason for revoking the passkey")
+    ),
+    responses((status = 204, description = "Passkey revoked")),
+    tag = "Profile"
+)]
 pub async fn delete_passkey(
     State(state): State<AppState>,
     TenantScopedConn {
@@ -166,3 +202,22 @@ fn parse_timestamp(value: &str) -> AppResult<NaiveDateTime> {
         .map_err(|_| AppError::bad_request("invalid expires_at timestamp"))?;
     Ok(dt.naive_utc())
 }
+
+#[derive(utoipa::OpenApi)]
+#[openapi(
+    paths(
+        crate::routes::profile::list_webdav_tokens,
+        crate::routes::profile::create_webdav_token,
+        crate::routes::profile::delete_webdav_token,
+        crate::routes::profile::list_passkeys,
+        crate::routes::profile::delete_passkey
+    ),
+    components(schemas(
+        crate::routes::profile::WebdavTokenResponse,
+        crate::routes::profile::WebdavTokenCreatedResponse,
+        crate::routes::profile::CreateWebdavTokenRequest,
+        crate::routes::profile::RevokePasskeyQuery,
+        crate::auth::passkeys::PasskeySummary
+    ))
+)]
+pub struct ProfileApiDoc;