openapi cleanup

backend/src/openapi.rs

@@ -1,7 +1,4 @@
-use serde::{Deserialize, Serialize};
-use serde_json::Value;
-use utoipa::{IntoParams, OpenApi, ToSchema};
-use uuid::Uuid;
+use utoipa::OpenApi;
 
 #[derive(OpenApi)]
 #[openapi(
@@ -68,68 +65,72 @@ use uuid::Uuid;
             schemas::SignupStartRequest,
             schemas::SignupStartResponse,
             schemas::SignupFinishRequest,
-            schemas::AccessTokenResponse,
+            schemas::LoginResponse,
+            schemas::LoginResponseVariants,
             schemas::TenantSnippet,
             schemas::TenantSelectionResponse,
             schemas::TenantSelectionRequest,
             schemas::TenantListResponse,
-            schemas::LoginResponseVariants,
             schemas::RegistrationChallengeResponse,
             schemas::AuthenticationChallengeResponse,
             schemas::PasskeySummary,
             schemas::PasskeyRegistrationFinishPayload,
             schemas::PasskeyLoginStartPayload,
             schemas::PasskeyLoginFinishPayload,
+            schemas::DocumentListQuery,
+            schemas::DocumentStatusFilter,
             schemas::DocumentResponse,
             schemas::DocumentDetailResponse,
+            schemas::DocumentMetadataUpdate,
             schemas::DocumentVersionResponse,
             schemas::DocumentVersionDetailResponse,
-            schemas::DocumentAssetSummary,
-            schemas::DocumentAssetDetail,
-            schemas::DocumentAssetObject,
+            schemas::DocumentAssetResponse,
+            schemas::DocumentAssetDetailResponse,
+            schemas::DocumentAssetObjectResponse,
             schemas::DocumentTypeResponse,
             schemas::CreateDocumentTypeRequest,
             schemas::UpdateDocumentTypeRequest,
-            schemas::DocumentCorrespondent,
-            schemas::DocumentTag,
+            schemas::DocumentCorrespondentResponse,
+            schemas::TagResponse,
             schemas::UpdateDocumentRequest,
-            schemas::BulkMoveDocumentsRequest,
-            schemas::BulkMoveDocumentsResponse,
+            schemas::RestoreDocumentRequest,
+            schemas::BulkMoveRequest,
+            schemas::BulkMoveResponse,
             schemas::AssignTagsRequest,
             schemas::MoveDocumentRequest,
+            schemas::BulkTagAction,
             schemas::BulkTagRequest,
             schemas::BulkTagResponse,
-            schemas::CorrespondentAssignment,
-            schemas::BulkTagAction,
-            schemas::BulkCorrespondentsRequest,
-            schemas::BulkCorrespondentsResponse,
-            schemas::BulkCorrespondentAction,
+            schemas::CorrespondentAssignmentInput,
             schemas::AssignCorrespondentsRequest,
-            schemas::ReanalyzeRequest,
-            schemas::ReanalyzeResponse,
-            schemas::DocumentAssetRequestParams,
+            schemas::BulkCorrespondentAction,
+            schemas::BulkCorrespondentsRequest,
+            schemas::BulkCorrespondentResponse,
+            schemas::BulkReanalyzeSelectionRequest,
+            schemas::BulkReanalyzeResponse,
+            schemas::AssetRequestQuery,
             schemas::AssetObjectsQuery,
             schemas::DocumentCheckQuery,
             schemas::DocumentCheckResponse,
             schemas::UploadDocumentForm,
             schemas::CreateFolderRequest,
             schemas::EnsureFolderPathRequest,
-            schemas::FolderResponse,
             schemas::FolderInfo,
+            schemas::FolderResponse,
+            schemas::FolderContentsQuery,
             schemas::FolderContentsResponse,
-            schemas::FolderDocumentSummary,
             schemas::UpdateFolderRequest,
-            schemas::FolderContentsParams,
             schemas::TagCatalogEntry,
             schemas::CreateTagRequest,
             schemas::UpdateTagRequest,
             schemas::CorrespondentUsage,
-            schemas::CorrespondentCatalogEntry,
+            schemas::CorrespondentSummary,
             schemas::CreateCorrespondentRequest,
             schemas::UpdateCorrespondentRequest,
             schemas::WebdavTokenResponse,
             schemas::WebdavTokenCreatedResponse,
             schemas::CreateWebdavTokenRequest,
+            schemas::RevokePasskeyQuery,
         )
     ),
     tags(
@@ -418,8 +419,8 @@ mod doc {
     #[utoipa::path(
         post,
         path = "/api/documents/bulk/move",
-        request_body = BulkMoveDocumentsRequest,
-        responses((status = 200, description = "Bulk move outcome", body = BulkMoveDocumentsResponse)),
+        request_body = BulkMoveRequest,
+        responses((status = 200, description = "Bulk move outcome", body = BulkMoveResponse)),
         tag = "Documents"
     )]
     pub(super) fn bulk_move_documents() {}
@@ -437,7 +438,7 @@ mod doc {
         post,
         path = "/api/documents/bulk/correspondents",
         request_body = BulkCorrespondentsRequest,
-        responses((status = 200, description = "Bulk correspondents outcome", body = BulkCorrespondentsResponse)),
+        responses((status = 200, description = "Bulk correspondents outcome", body = BulkCorrespondentResponse)),
         tag = "Documents"
     )]
     pub(super) fn bulk_assign_correspondents() {}
@@ -467,8 +468,8 @@ mod doc {
     #[utoipa::path(
         post,
         path = "/api/documents/bulk/reanalyze",
-        request_body = ReanalyzeRequest,
-        responses((status = 200, description = "Reanalyze queued", body = ReanalyzeResponse)),
+        request_body = BulkReanalyzeSelectionRequest,
+        responses((status = 200, description = "Reanalyze queued", body = BulkReanalyzeResponse)),
         tag = "Documents"
     )]
     pub(super) fn reanalyze_selected_documents() {}
@@ -477,7 +478,7 @@ mod doc {
         get,
         path = "/api/documents/{id}/assets",
         params(("id" = Uuid, Path, description = "Document ID")),
-        responses((status = 200, description = "Document assets", body = [DocumentAssetSummary])),
+        responses((status = 200, description = "Document assets", body = [DocumentAssetResponse])),
         tag = "Assets"
     )]
     pub(super) fn list_document_assets() {}
@@ -487,7 +488,7 @@ mod doc {
         path = "/api/documents/{id}/assets",
         params(
             ("id" = Uuid, Path, description = "Document ID"),
-            DocumentAssetRequestParams
+            AssetRequestQuery
         ),
         responses((status = 202, description = "Asset generation requested")),
         tag = "Assets"
@@ -501,7 +502,7 @@ mod doc {
             ("asset_id" = Uuid, Path, description = "Asset ID"),
             AssetObjectsQuery
         ),
-        responses((status = 200, description = "Asset detail", body = DocumentAssetDetail)),
+        responses((status = 200, description = "Asset detail", body = DocumentAssetDetailResponse)),
         tag = "Assets"
     )]
     pub(super) fn get_document_asset() {}
@@ -541,7 +542,7 @@ mod doc {
         path = "/api/folders/{id}/contents",
         params(
             ("id" = Uuid, Path, description = "Folder ID"),
-            FolderContentsParams
+            FolderContentsQuery
         ),
         responses((status = 200, description = "Folder contents", body = FolderContentsResponse)),
         tag = "Folders"
@@ -735,525 +736,42 @@ mod tests {
 }
 
 pub mod schemas {
-    use super::*;
-
     pub use crate::auth::passkeys::{
         AuthenticationChallengeResponse, PasskeyLoginFinishPayload, PasskeyLoginStartPayload,
         PasskeyRegistrationFinishPayload, PasskeySummary, RegistrationChallengeResponse,
     };
-    use webauthn_rs::prelude::RegisterPublicKeyCredential;
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct LoginRequest {
-        pub username: String,
-        pub password: String,
-        #[schema(nullable)]
-        pub preferred_tenant_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct SignupStartRequest {
-        pub username: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct SignupStartResponse {
-        pub signup_token: String,
-        pub challenge: RegistrationChallengeResponse,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct SignupFinishRequest {
-        pub signup_token: String,
-        #[schema(value_type = Object)]
-        pub credential: RegisterPublicKeyCredential,
-        #[schema(nullable)]
-        pub nickname: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct AccessTokenResponse {
-        pub access_token: String,
-        pub token_type: String,
-        pub expires_in: i64,
-        pub tenant: TenantSnippet,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct TenantSnippet {
-        pub id: Uuid,
-        pub name: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct TenantSelectionResponse {
-        pub access_token: String,
-        pub tenants: Vec<TenantSnippet>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct TenantSelectionRequest {
-        pub tenant_id: Uuid,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct TenantListResponse {
-        pub tenants: Vec<TenantSnippet>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    #[serde(untagged)]
-    pub enum LoginResponseVariants {
-        Token(AccessTokenResponse),
-        Selection(TenantSelectionResponse),
-    }
-
-    #[derive(Serialize, Deserialize, IntoParams, ToSchema)]
-    #[into_params(parameter_in = Query)]
-    pub struct DocumentListQuery {
-        pub folder_id: Option<Uuid>,
-        #[schema(nullable)]
-        pub include_descendants: Option<bool>,
-        pub query: Option<String>,
-        pub tags: Option<String>,
-        pub correspondents: Option<String>,
-        pub document_types: Option<String>,
-        #[serde(default = "default_document_status_filter")]
-        #[schema(default = "active")]
-        pub status: DocumentStatusFilter,
-    }
-
-    fn default_document_status_filter() -> DocumentStatusFilter {
-        DocumentStatusFilter::Active
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    #[serde(rename_all = "lowercase")]
-    pub enum DocumentStatusFilter {
-        Active,
-        Deleted,
-        All,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentTag {
-        pub id: Uuid,
-        pub label: String,
-        #[schema(nullable)]
-        pub color: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentAssetObject {
-        pub id: Uuid,
-        pub ordinal: i32,
-        pub metadata: Value,
-        #[schema(nullable)]
-        pub url: Option<String>,
-        #[schema(nullable)]
-        pub expires_at: Option<i64>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentAssetSummary {
-        pub id: Uuid,
-        pub asset_type: String,
-        pub mime_type: String,
-        pub metadata: Value,
-        #[schema(nullable)]
-        pub cardinality: Option<i32>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentAssetDetail {
-        pub id: Uuid,
-        pub asset_type: String,
-        pub mime_type: String,
-        pub metadata: Value,
-        pub created_at: String,
-        #[schema(nullable)]
-        pub cardinality: Option<i32>,
-        pub objects: Vec<DocumentAssetObject>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentVersionResponse {
-        pub id: Uuid,
-        pub version_number: i32,
-        pub size_bytes: i64,
-        pub checksum: String,
-        pub created_at: String,
-        pub metadata: Value,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentVersionDetailResponse {
-        #[serde(flatten)]
-        pub version: DocumentVersionResponse,
-        #[serde(default, skip_serializing_if = "Vec::is_empty")]
-        pub assets: Vec<DocumentAssetSummary>,
-        pub download_path: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentCorrespondent {
-        pub id: Uuid,
-        pub name: String,
-        pub metadata: Value,
-        pub assigned_at: String,
-    }
-
+    pub use crate::documents::asset::{
+        DocumentAssetDetailResponse, DocumentAssetObjectResponse, DocumentAssetResponse,
+        DocumentVersionDetailResponse, DocumentVersionResponse,
+    };
+    pub use crate::documents::correspondents::DocumentCorrespondentResponse;
+    pub use crate::routes::auth::{
+        LoginRequest, LoginResponse, LoginResponseVariants, SignupFinishRequest,
+        SignupStartRequest, SignupStartResponse, TenantListResponse, TenantSelectionRequest,
+        TenantSelectionResponse, TenantSnippet,
+    };
+    pub use crate::routes::correspondents::{
+        CorrespondentSummary, CorrespondentUsage, CreateCorrespondentRequest,
+        UpdateCorrespondentRequest,
+    };
     pub use crate::routes::document_types::{CreateDocumentTypeRequest, UpdateDocumentTypeRequest};
-    pub use crate::routes::documents::DocumentTypeResponse;
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentResponse {
-        pub id: Uuid,
-        pub filename: String,
-        pub title: String,
-        pub original_name: String,
-        #[schema(nullable)]
-        pub content_type: Option<String>,
-        #[schema(nullable)]
-        pub folder_id: Option<Uuid>,
-        pub created_at: String,
-        pub updated_at: String,
-        #[schema(nullable)]
-        pub deleted_at: Option<String>,
-        #[schema(nullable)]
-        pub issued_at: Option<String>,
-        pub metadata: Value,
-        #[schema(nullable)]
-        pub document_type_id: Option<Uuid>,
-        #[schema(nullable)]
-        pub document_type: Option<DocumentTypeResponse>,
-        pub tags: Vec<DocumentTag>,
-        #[serde(default, skip_serializing_if = "Vec::is_empty")]
-        pub correspondents: Vec<DocumentCorrespondent>,
-        #[schema(nullable)]
-        pub current_version: Option<DocumentVersionDetailResponse>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentDetailResponse {
-        pub document: DocumentResponse,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentMetadataUpdate {
-        pub value: Value,
-        #[serde(default)]
-        #[schema(default = false)]
-        pub replace: bool,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct RestoreDocumentRequest {
-        #[schema(nullable)]
-        pub folder_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct UpdateDocumentRequest {
-        #[schema(nullable)]
-        pub title: Option<String>,
-        #[schema(nullable, value_type = Option<String>)]
-        pub issued_at: Option<Value>,
-        #[schema(nullable)]
-        pub metadata: Option<DocumentMetadataUpdate>,
-        #[schema(nullable)]
-        pub document_type_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkMoveDocumentsRequest {
-        pub document_ids: Vec<Uuid>,
-        #[schema(nullable)]
-        pub folder_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkMoveDocumentsResponse {
-        pub updated: usize,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct AssignTagsRequest {
-        pub tag_ids: Vec<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct MoveDocumentRequest {
-        #[schema(nullable)]
-        pub folder_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    #[serde(rename_all = "snake_case")]
-    pub enum BulkTagAction {
-        Add,
-        Remove,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkTagRequest {
-        pub document_ids: Vec<Uuid>,
-        pub tag_ids: Vec<Uuid>,
-        pub action: BulkTagAction,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkTagResponse {
-        pub added: usize,
-        pub removed: usize,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CorrespondentAssignment {
-        pub correspondent_id: Uuid,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct AssignCorrespondentsRequest {
-        pub assignments: Vec<CorrespondentAssignment>,
-        #[serde(default)]
-        pub replace: bool,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    #[serde(rename_all = "lowercase")]
-    pub enum BulkCorrespondentAction {
-        Add,
-        Remove,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkCorrespondentsRequest {
-        pub document_ids: Vec<Uuid>,
-        pub assignments: Vec<CorrespondentAssignment>,
-        #[serde(default = "default_bulk_correspondent_action")]
-        pub action: BulkCorrespondentAction,
-    }
-
-    fn default_bulk_correspondent_action() -> BulkCorrespondentAction {
-        BulkCorrespondentAction::Add
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct BulkCorrespondentsResponse {
-        pub assigned: usize,
-        pub removed: usize,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct ReanalyzeRequest {
-        pub document_ids: Vec<Uuid>,
-        #[serde(default)]
-        pub force: bool,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct ReanalyzeResponse {
-        pub queued: usize,
-    }
-
-    #[derive(Serialize, Deserialize, IntoParams, ToSchema)]
-    #[into_params(parameter_in = Query)]
-    pub struct DocumentAssetRequestParams {
-        #[serde(default)]
-        pub force: Option<bool>,
-    }
-
-    #[derive(Serialize, Deserialize, IntoParams, ToSchema)]
-    #[into_params(parameter_in = Query)]
-    pub struct AssetObjectsQuery {
-        #[serde(default)]
-        pub start: Option<i32>,
-        #[serde(default)]
-        pub limit: Option<i32>,
-    }
-
-    #[derive(Serialize, Deserialize, IntoParams, ToSchema)]
-    #[into_params(parameter_in = Query)]
-    pub struct DocumentCheckQuery {
-        pub checksum: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct DocumentCheckResponse {
-        pub exists: bool,
-        #[schema(nullable)]
-        pub document_id: Option<Uuid>,
-        #[schema(nullable)]
-        pub title: Option<String>,
-        #[schema(nullable)]
-        pub filename: Option<String>,
-        #[schema(nullable)]
-        pub version_id: Option<Uuid>,
-        #[schema(nullable)]
-        pub version_number: Option<i32>,
-        #[schema(nullable)]
-        pub created_at: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct UploadDocumentForm {
-        #[schema(value_type = String, format = Binary)]
-        pub file: String,
-        #[schema(nullable)]
-        pub folder_id: Option<Uuid>,
-        #[schema(nullable)]
-        pub metadata: Option<Value>,
-        #[schema(nullable)]
-        pub title: Option<String>,
-        #[schema(nullable, value_type = Vec<Uuid>)]
-        pub tag_ids: Option<Vec<Uuid>>,
-        #[schema(nullable, value_type = Vec<CorrespondentAssignment>)]
-        pub correspondents: Option<Vec<CorrespondentAssignment>>,
-        #[schema(nullable, example = "2024-01-01T00:00:00Z")]
-        pub issued_at: Option<String>,
-        #[schema(nullable)]
-        pub skip_existing: Option<bool>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CreateFolderRequest {
-        pub name: String,
-        #[schema(nullable)]
-        pub parent_id: Option<Uuid>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct EnsureFolderPathRequest {
-        #[schema(nullable)]
-        pub parent_id: Option<Uuid>,
-        pub segments: Vec<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct FolderInfo {
-        pub id: Uuid,
-        pub name: String,
-        #[schema(nullable)]
-        pub parent_id: Option<Uuid>,
-        pub created_at: String,
-        pub updated_at: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct FolderResponse {
-        pub folder: FolderInfo,
-    }
-
-    #[derive(Serialize, Deserialize, IntoParams, ToSchema)]
-    #[into_params(parameter_in = Query)]
-    pub struct FolderContentsParams {
-        #[serde(default)]
-        pub include_documents: Option<bool>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct FolderDocumentSummary {
-        pub id: Uuid,
-        pub title: String,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct FolderContentsResponse {
-        #[schema(nullable)]
-        pub folder: Option<FolderInfo>,
-        pub subfolders: Vec<FolderInfo>,
-        pub documents: Vec<FolderDocumentSummary>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct UpdateFolderRequest {
-        #[schema(nullable)]
-        pub parent_id: Option<Option<Uuid>>,
-        #[schema(nullable)]
-        pub name: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct TagCatalogEntry {
-        pub id: Uuid,
-        pub label: String,
-        #[schema(nullable)]
-        pub color: Option<String>,
-        pub usage_count: i64,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CreateTagRequest {
-        pub label: String,
-        #[schema(nullable)]
-        pub color: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct UpdateTagRequest {
-        #[schema(nullable)]
-        pub label: Option<Option<String>>,
-        #[schema(nullable)]
-        pub color: Option<Option<String>>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CorrespondentUsage {
-        pub total: i64,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CorrespondentCatalogEntry {
-        pub id: Uuid,
-        pub name: String,
-        pub metadata: Value,
-        pub created_at: String,
-        pub updated_at: String,
-        pub usage: CorrespondentUsage,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CreateCorrespondentRequest {
-        pub name: String,
-        #[schema(default, value_type = Object)]
-        pub metadata: Value,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct UpdateCorrespondentRequest {
-        #[schema(nullable)]
-        pub name: Option<String>,
-        #[schema(nullable)]
-        pub metadata: Option<Value>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct WebdavTokenResponse {
-        pub id: Uuid,
-        pub tenant_id: Uuid,
-        #[schema(nullable)]
-        pub label: Option<String>,
-        pub created_at: String,
-        #[schema(nullable)]
-        pub last_used_at: Option<String>,
-        #[schema(nullable)]
-        pub expires_at: Option<String>,
-        #[schema(nullable)]
-        pub revoked_at: Option<String>,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct WebdavTokenCreatedResponse {
-        pub token: String,
-        pub token_info: WebdavTokenResponse,
-    }
-
-    #[derive(Serialize, Deserialize, ToSchema)]
-    pub struct CreateWebdavTokenRequest {
-        #[schema(nullable)]
-        pub label: Option<String>,
-        #[schema(nullable, example = "2025-01-01T00:00:00Z")]
-        pub expires_at: Option<String>,
-    }
+    pub use crate::routes::documents::{
+        AssetObjectsQuery, AssetRequestQuery, AssignCorrespondentsRequest, AssignTagsRequest,
+        BulkCorrespondentAction, BulkCorrespondentResponse, BulkCorrespondentsRequest,
+        BulkMoveRequest, BulkMoveResponse, BulkReanalyzeResponse, BulkReanalyzeSelectionRequest,
+        BulkTagAction, BulkTagRequest, BulkTagResponse, CorrespondentAssignmentInput,
+        DocumentCheckQuery, DocumentCheckResponse, DocumentDetailResponse, DocumentListQuery,
+        DocumentMetadataUpdate, DocumentResponse, DocumentStatusFilter, DocumentTypeResponse,
+        MoveDocumentRequest, RestoreDocumentRequest, TagResponse, UpdateDocumentRequest,
+        UploadDocumentForm,
+    };
+    pub use crate::routes::folders::{
+        CreateFolderRequest, EnsureFolderPathRequest, FolderContentsQuery, FolderContentsResponse,
+        FolderInfo, FolderResponse, UpdateFolderRequest,
+    };
+    pub use crate::routes::profile::{
+        CreateWebdavTokenRequest, RevokePasskeyQuery, WebdavTokenCreatedResponse,
+        WebdavTokenResponse,
+    };
+    pub use crate::routes::tags::{CreateTagRequest, TagCatalogEntry, UpdateTagRequest};
 }