diff --git a/src/api2/access/user.rs b/src/api2/access/user.rs
index 49ddff65..72c79def 100644
--- a/src/api2/access/user.rs
+++ b/src/api2/access/user.rs
@@ -249,10 +249,7 @@ pub fn create_user(password: Option<String>, param: Value) -> Result<(), Error>
             },
          },
     },
-    returns: {
-        description: "The user configuration (with config digest).",
-        type: user::User,
-    },
+    returns: { type: user::User },
     access: {
         permission: &Permission::Or(&[
             &Permission::Privilege(&["access", "users"], PRIV_SYS_AUDIT, false),
@@ -468,10 +465,7 @@ pub fn delete_user(userid: Userid, digest: Option<String>) -> Result<(), Error>
             },
         },
     },
-    returns: {
-        description: "Get API token metadata (with config digest).",
-        type: user::ApiToken,
-    },
+    returns: { type: user::ApiToken },
     access: {
         permission: &Permission::Or(&[
             &Permission::Privilege(&["access", "users"], PRIV_SYS_AUDIT, false),
diff --git a/src/api2/admin/datastore.rs b/src/api2/admin/datastore.rs
index df60dab6..16fee943 100644
--- a/src/api2/admin/datastore.rs
+++ b/src/api2/admin/datastore.rs
@@ -975,10 +975,7 @@ pub fn garbage_collection_status(
     returns: {
         description: "List the accessible datastores.",
         type: Array,
-        items: {
-            description: "Datastore name and description.",
-            type: DataStoreListItem,
-        },
+        items: { type: DataStoreListItem },
     },
     access: {
         permission: &Permission::Anybody,
diff --git a/src/api2/config/datastore.rs b/src/api2/config/datastore.rs
index 4ca4bf0e..a4d25989 100644
--- a/src/api2/config/datastore.rs
+++ b/src/api2/config/datastore.rs
@@ -151,10 +151,7 @@ pub fn create_datastore(param: Value) -> Result<(), Error> {
             },
         },
     },
-    returns: {
-        description: "The datastore configuration (with config digest).",
-        type: datastore::DataStoreConfig,
-    },
+    returns: { type: datastore::DataStoreConfig },
     access: {
         permission: &Permission::Privilege(&["datastore", "{name}"], PRIV_DATASTORE_AUDIT, false),
     },
diff --git a/src/api2/config/remote.rs b/src/api2/config/remote.rs
index 7ae1d244..49db68ce 100644
--- a/src/api2/config/remote.rs
+++ b/src/api2/config/remote.rs
@@ -19,10 +19,7 @@ use crate::config::acl::{PRIV_REMOTE_AUDIT, PRIV_REMOTE_MODIFY};
     returns: {
         description: "The list of configured remotes (with config digest).",
         type: Array,
-        items: {
-            type: remote::Remote,
-            description: "Remote configuration (without password).",
-        },
+        items: { type: remote::Remote },
     },
     access: {
         description: "List configured remotes filtered by Remote.Audit privileges",
@@ -124,10 +121,7 @@ pub fn create_remote(password: String, param: Value) -> Result<(), Error> {
             },
         },
     },
-    returns: {
-        description: "The remote configuration (with config digest).",
-        type: remote::Remote,
-    },
+    returns: { type: remote::Remote },
     access: {
         permission: &Permission::Privilege(&["remote", "{name}"], PRIV_REMOTE_AUDIT, false),
     }
@@ -347,10 +341,7 @@ pub async fn remote_client(remote: remote::Remote) -> Result<HttpClient, Error>
     returns: {
         description: "List the accessible datastores.",
         type: Array,
-        items: {
-            description: "Datastore name and description.",
-            type: DataStoreListItem,
-        },
+        items: { type: DataStoreListItem },
     },
 )]
 /// List datastores of a remote.cfg entry
diff --git a/src/api2/config/sync.rs b/src/api2/config/sync.rs
index bdad21e6..1192d15f 100644
--- a/src/api2/config/sync.rs
+++ b/src/api2/config/sync.rs
@@ -182,10 +182,7 @@ pub fn create_sync_job(
             },
         },
     },
-    returns: {
-        description: "The sync job configuration.",
-        type: sync::SyncJobConfig,
-    },
+    returns: { type: sync::SyncJobConfig },
     access: {
         description: "Limited to sync job entries where user has Datastore.Audit on target datastore, and Remote.Audit on source remote.",
         permission: &Permission::Anybody,
diff --git a/src/api2/config/verify.rs b/src/api2/config/verify.rs
index 2c03e33e..2be2772d 100644
--- a/src/api2/config/verify.rs
+++ b/src/api2/config/verify.rs
@@ -127,10 +127,7 @@ pub fn create_verification_job(
             },
         },
     },
-    returns: {
-        description: "The verification job configuration.",
-        type: verify::VerificationJobConfig,
-    },
+    returns: { type: verify::VerificationJobConfig },
     access: {
         permission: &Permission::Anybody,
         description: "Requires Datastore.Audit or Datastore.Verify on job's datastore.",
diff --git a/src/api2/node/network.rs b/src/api2/node/network.rs
index f737684d..d9c031ae 100644
--- a/src/api2/node/network.rs
+++ b/src/api2/node/network.rs
@@ -102,10 +102,7 @@ pub fn list_network_devices(
             },
         },
     },
-    returns: {
-        description: "The network interface configuration (with config digest).",
-        type: Interface,
-    },
+    returns: { type: Interface },
     access: {
         permission: &Permission::Privilege(&["system", "network", "interfaces", "{name}"], PRIV_SYS_AUDIT, false),
     },
@@ -135,7 +132,6 @@ pub fn read_interface(iface: String) -> Result<Value, Error> {
                 schema: NETWORK_INTERFACE_NAME_SCHEMA,
             },
             "type": {
-                description: "Interface type.",
                 type: NetworkInterfaceType,
                 optional: true,
             },
@@ -388,7 +384,6 @@ pub enum DeletableProperty {
                 schema: NETWORK_INTERFACE_NAME_SCHEMA,
             },
             "type": {
-                description: "Interface type. If specified, need to match the current type.",
                 type: NetworkInterfaceType,
                 optional: true,
             },
diff --git a/src/api2/node/subscription.rs b/src/api2/node/subscription.rs
index 67797fd5..c935fa2c 100644
--- a/src/api2/node/subscription.rs
+++ b/src/api2/node/subscription.rs
@@ -73,10 +73,7 @@ pub fn check_subscription(
             },
         },
     },
-    returns: {
-        description: "Subscription status.",
-        type: SubscriptionInfo,
-    },
+    returns: { type: SubscriptionInfo },
     access: {
         permission: &Permission::Anybody,
     },
diff --git a/src/api2/node/tasks.rs b/src/api2/node/tasks.rs
index 3f06ec70..1a9fb942 100644
--- a/src/api2/node/tasks.rs
+++ b/src/api2/node/tasks.rs
@@ -166,7 +166,6 @@ fn check_task_access(auth_id: &Authid, upid: &UPID) -> Result<(), Error> {
             },
             user: {
                 type: Userid,
-                description: "The user who started the task.",
             },
             tokenid: {
                 type: Tokenname,
diff --git a/src/bin/proxmox_backup_client/key.rs b/src/bin/proxmox_backup_client/key.rs
index 05cd5165..88fa5340 100644
--- a/src/bin/proxmox_backup_client/key.rs
+++ b/src/bin/proxmox_backup_client/key.rs
@@ -372,7 +372,6 @@ fn create_master_key() -> Result<(), Error> {
             },
             "output-format": {
                 type: PaperkeyFormat,
-                description: "Output format. Text or Html.",
                 optional: true,
             },
         },