You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2020/09/15 15:56:52 UTC

[camel] 03/22: CAMEL-15478: api-component should generate @ApiParam with more fine grained details so we know which parameter is for which api method.

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch api
in repository https://gitbox.apache.org/repos/asf/camel.git

commit a4e8c6cd0569d86a0800d7f108a5ae4397a0a3d1
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Sat Sep 12 11:07:22 2020 +0200

    CAMEL-15478: api-component should generate @ApiParam with more fine grained details so we know which parameter is for which api method.
---
 .../AddOnGatewayEndpointConfiguration.java         |   5 +-
 .../AddressGatewayEndpointConfiguration.java       |   5 +-
 .../ClientTokenGatewayEndpointConfiguration.java   |   5 +-
 ...rdVerificationGatewayEndpointConfiguration.java |   5 +-
 .../CustomerGatewayEndpointConfiguration.java      |   5 +-
 .../DiscountGatewayEndpointConfiguration.java      |   5 +-
 .../DisputeGatewayEndpointConfiguration.java       |   5 +-
 ...DocumentUploadGatewayEndpointConfiguration.java |   5 +-
 ...erchantAccountGatewayEndpointConfiguration.java |   5 +-
 .../PaymentMethodGatewayEndpointConfiguration.java |   5 +-
 ...entMethodNonceGatewayEndpointConfiguration.java |   5 +-
 .../PlanGatewayEndpointConfiguration.java          |   5 +-
 .../ReportGatewayEndpointConfiguration.java        |   5 +-
 ...ntBatchSummaryGatewayEndpointConfiguration.java |   5 +-
 .../SubscriptionGatewayEndpointConfiguration.java  |   5 +-
 .../TransactionGatewayEndpointConfiguration.java   |   5 +-
 ...okNotificationGatewayEndpointConfiguration.java |   5 +-
 .../twilio/AccountEndpointConfiguration.java       |   5 +-
 ...sDependentPhoneNumberEndpointConfiguration.java |   5 +-
 .../twilio/AddressEndpointConfiguration.java       |   5 +-
 .../twilio/ApplicationEndpointConfiguration.java   |   5 +-
 ...blePhoneNumberCountryEndpointConfiguration.java |   5 +-
 ...oneNumberCountryLocalEndpointConfiguration.java |   5 +-
 ...neNumberCountryMobileEndpointConfiguration.java |   5 +-
 ...NumberCountryTollFreeEndpointConfiguration.java |   5 +-
 .../twilio/CallEndpointConfiguration.java          |   5 +-
 .../twilio/CallFeedbackEndpointConfiguration.java  |   5 +-
 .../CallFeedbackSummaryEndpointConfiguration.java  |   5 +-
 .../CallNotificationEndpointConfiguration.java     |   5 +-
 .../twilio/CallRecordingEndpointConfiguration.java |   5 +-
 .../twilio/ConferenceEndpointConfiguration.java    |   5 +-
 ...ConferenceParticipantEndpointConfiguration.java |   5 +-
 .../twilio/ConnectAppEndpointConfiguration.java    |   5 +-
 .../IncomingPhoneNumberEndpointConfiguration.java  |   5 +-
 ...omingPhoneNumberLocalEndpointConfiguration.java |   5 +-
 ...mingPhoneNumberMobileEndpointConfiguration.java |   5 +-
 ...ngPhoneNumberTollFreeEndpointConfiguration.java |   5 +-
 .../component/twilio/KeyEndpointConfiguration.java |   5 +-
 .../twilio/MessageEndpointConfiguration.java       |   5 +-
 .../MessageFeedbackEndpointConfiguration.java      |   5 +-
 .../twilio/MessageMediaEndpointConfiguration.java  |   5 +-
 .../twilio/NewKeyEndpointConfiguration.java        |   5 +-
 .../twilio/NewSigningKeyEndpointConfiguration.java |   5 +-
 .../twilio/NotificationEndpointConfiguration.java  |   5 +-
 .../OutgoingCallerIdEndpointConfiguration.java     |   5 +-
 .../twilio/QueueEndpointConfiguration.java         |   5 +-
 .../twilio/QueueMemberEndpointConfiguration.java   |   5 +-
 .../RecordingAddOnResultEndpointConfiguration.java |   5 +-
 ...ingAddOnResultPayloadEndpointConfiguration.java |   5 +-
 .../twilio/RecordingEndpointConfiguration.java     |   5 +-
 ...ecordingTranscriptionEndpointConfiguration.java |   5 +-
 .../twilio/ShortCodeEndpointConfiguration.java     |   5 +-
 .../twilio/SigningKeyEndpointConfiguration.java    |   5 +-
 .../twilio/SipCredentialEndpointConfiguration.java |   5 +-
 .../SipCredentialListEndpointConfiguration.java    |   5 +-
 ...CredentialListMappingEndpointConfiguration.java |   5 +-
 .../twilio/SipDomainEndpointConfiguration.java     |   5 +-
 ...essControlListMappingEndpointConfiguration.java |   5 +-
 ...ipIpAccessControlListEndpointConfiguration.java |   5 +-
 ...sControlListIpAddressEndpointConfiguration.java |   5 +-
 .../twilio/TokenEndpointConfiguration.java         |   5 +-
 .../twilio/TranscriptionEndpointConfiguration.java |   5 +-
 .../UsageRecordAllTimeEndpointConfiguration.java   |   5 +-
 .../UsageRecordDailyEndpointConfiguration.java     |   5 +-
 .../twilio/UsageRecordEndpointConfiguration.java   |   5 +-
 .../UsageRecordLastMonthEndpointConfiguration.java |   5 +-
 .../UsageRecordMonthlyEndpointConfiguration.java   |   5 +-
 .../UsageRecordThisMonthEndpointConfiguration.java |   5 +-
 .../UsageRecordTodayEndpointConfiguration.java     |   5 +-
 .../UsageRecordYearlyEndpointConfiguration.java    |   5 +-
 .../UsageRecordYesterdayEndpointConfiguration.java |   5 +-
 .../twilio/UsageTriggerEndpointConfiguration.java  |   5 +-
 .../ValidationRequestEndpointConfiguration.java    |   5 +-
 .../java/org/apache/camel/spi/ApiParams.java       |   7 +
 .../apache/camel/tooling/util/JavadocHelper.java   |   5 +-
 .../camel/tooling/util/JavadocHelperTest.java      |  16 +++
 .../maven/AbstractApiMethodGeneratorMojo.java      |  14 +-
 .../camel/maven/ApiComponentGeneratorMojo.java     |   1 +
 .../main/java/org/apache/camel/maven/ApiProxy.java |  10 ++
 .../maven/JavaSourceApiMethodGeneratorMojo.java    |  40 +-----
 .../org/apache/camel/maven/JavaSourceParser.java   |  50 ++++++-
 .../org/apache/camel/maven/SignatureModel.java     |  18 +++
 .../src/main/resources/api-endpoint-config.vm      |   5 +-
 .../org/apache/camel/component/test/TestProxy.java |   3 +
 .../apache/camel/maven/JavaSourceParserTest.java   |  16 +++
 .../src/test/resources/CustomGateway.java          | 156 +++++++++++++++++++++
 .../main/java/org/apache/camel/spi/ApiParams.java  |   7 +
 87 files changed, 519 insertions(+), 194 deletions(-)

diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddOnGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddOnGatewayEndpointConfiguration.java
index 1996a6c..4ed814c 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddOnGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddOnGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.AddOnGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.AddOnGateway}.
  */
-@ApiParams(apiName = "addOn", apiMethods = {@ApiMethod(methodName = "all")})
+@ApiParams(apiName = "addOn", description = "",
+           apiMethods = {@ApiMethod(methodName = "all")})
 @UriParams
 @Configurer
 public final class AddOnGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddressGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddressGatewayEndpointConfiguration.java
index 3808124..e1c2573 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddressGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/AddressGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.AddressGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.AddressGateway}.
  */
-@ApiParams(apiName = "address", apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "update")})
+@ApiParams(apiName = "address", description = "Provides methods to create, delete, find, and update Address objects",
+           apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "update")})
 @UriParams
 @Configurer
 public final class AddressGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ClientTokenGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ClientTokenGatewayEndpointConfiguration.java
index 0658e92..cb7e060 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ClientTokenGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ClientTokenGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.ClientTokenGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.ClientTokenGateway}.
  */
-@ApiParams(apiName = "clientToken", apiMethods = {@ApiMethod(methodName = "generate")})
+@ApiParams(apiName = "clientToken", description = "Generates client tokens, which are used to authenticate requests made directly on behalf of merchants This class does not need to be instantiated directly",
+           apiMethods = {@ApiMethod(methodName = "generate")})
 @UriParams
 @Configurer
 public final class ClientTokenGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CreditCardVerificationGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CreditCardVerificationGatewayEndpointConfiguration.java
index b38a9f3..0e16a39 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CreditCardVerificationGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CreditCardVerificationGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.CreditCardVerificationGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.CreditCardVerificationGateway}.
  */
-@ApiParams(apiName = "creditCardVerification", apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "search")})
+@ApiParams(apiName = "creditCardVerification", description = "",
+           apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "search")})
 @UriParams
 @Configurer
 public final class CreditCardVerificationGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CustomerGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CustomerGatewayEndpointConfiguration.java
index e224fad..4c4d9d5 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CustomerGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/CustomerGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.CustomerGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.CustomerGateway}.
  */
-@ApiParams(apiName = "customer", apiMethods = {@ApiMethod(methodName = "all"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "update")})
+@ApiParams(apiName = "customer", description = "Provides methods to create, delete, find, and update Customer objects",
+           apiMethods = {@ApiMethod(methodName = "all"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "update")})
 @UriParams
 @Configurer
 public final class CustomerGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DiscountGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DiscountGatewayEndpointConfiguration.java
index 568cf1ad..7fb9f96 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DiscountGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DiscountGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.DiscountGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.DiscountGateway}.
  */
-@ApiParams(apiName = "discount", apiMethods = {@ApiMethod(methodName = "all")})
+@ApiParams(apiName = "discount", description = "",
+           apiMethods = {@ApiMethod(methodName = "all")})
 @UriParams
 @Configurer
 public final class DiscountGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DisputeGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DisputeGatewayEndpointConfiguration.java
index 95ac889..247e57f 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DisputeGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DisputeGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.DisputeGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.DisputeGateway}.
  */
-@ApiParams(apiName = "dispute", apiMethods = {@ApiMethod(methodName = "accept"), @ApiMethod(methodName = "addFileEvidence"), @ApiMethod(methodName = "addTextEvidence"), @ApiMethod(methodName = "finalize"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "removeEvidence"), @ApiMethod(methodName = "search")})
+@ApiParams(apiName = "dispute", description = "Provides methods to interact with Dispute objects",
+           apiMethods = {@ApiMethod(methodName = "accept"), @ApiMethod(methodName = "addFileEvidence"), @ApiMethod(methodName = "addTextEvidence"), @ApiMethod(methodName = "finalize"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "removeEvidence"), @ApiMethod(methodName = "search")})
 @UriParams
 @Configurer
 public final class DisputeGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DocumentUploadGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DocumentUploadGatewayEndpointConfiguration.java
index c9990d1..0b7dd19 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DocumentUploadGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/DocumentUploadGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.DocumentUploadGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.DocumentUploadGateway}.
  */
-@ApiParams(apiName = "documentUpload", apiMethods = {@ApiMethod(methodName = "create")})
+@ApiParams(apiName = "documentUpload", description = "",
+           apiMethods = {@ApiMethod(methodName = "create")})
 @UriParams
 @Configurer
 public final class DocumentUploadGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/MerchantAccountGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/MerchantAccountGatewayEndpointConfiguration.java
index 6e58498..ae75bf4 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/MerchantAccountGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/MerchantAccountGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.MerchantAccountGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.MerchantAccountGateway}.
  */
-@ApiParams(apiName = "merchantAccount", apiMethods = {@ApiMethod(methodName = "all"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "createForCurrency"), @ApiMethod(methodName = "fetchMerchantAccounts"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "update")})
+@ApiParams(apiName = "merchantAccount", description = "",
+           apiMethods = {@ApiMethod(methodName = "all"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "createForCurrency"), @ApiMethod(methodName = "fetchMerchantAccounts"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "update")})
 @UriParams
 @Configurer
 public final class MerchantAccountGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodGatewayEndpointConfiguration.java
index 1c31b68..0ce7ad5 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.PaymentMethodGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.PaymentMethodGateway}.
  */
-@ApiParams(apiName = "paymentMethod", apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "grant"), @ApiMethod(methodName = "revoke"), @ApiMethod(methodName = "update")})
+@ApiParams(apiName = "paymentMethod", description = "",
+           apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "grant"), @ApiMethod(methodName = "revoke"), @ApiMethod(methodName = "update")})
 @UriParams
 @Configurer
 public final class PaymentMethodGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodNonceGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodNonceGatewayEndpointConfiguration.java
index 199fae0..eb7cc47 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodNonceGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PaymentMethodNonceGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.PaymentMethodNonceGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.PaymentMethodNonceGateway}.
  */
-@ApiParams(apiName = "paymentMethodNonce", apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "find")})
+@ApiParams(apiName = "paymentMethodNonce", description = "",
+           apiMethods = {@ApiMethod(methodName = "create"), @ApiMethod(methodName = "find")})
 @UriParams
 @Configurer
 public final class PaymentMethodNonceGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PlanGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PlanGatewayEndpointConfiguration.java
index 30d6efe..3f8f663 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PlanGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/PlanGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.PlanGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.PlanGateway}.
  */
-@ApiParams(apiName = "plan", apiMethods = {@ApiMethod(methodName = "all")})
+@ApiParams(apiName = "plan", description = "",
+           apiMethods = {@ApiMethod(methodName = "all")})
 @UriParams
 @Configurer
 public final class PlanGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ReportGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ReportGatewayEndpointConfiguration.java
index 54ee284..fdfcea7 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ReportGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/ReportGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.ReportGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.ReportGateway}.
  */
-@ApiParams(apiName = "report", apiMethods = {@ApiMethod(methodName = "transactionLevelFees")})
+@ApiParams(apiName = "report", description = "Provides methods to interact with reports",
+           apiMethods = {@ApiMethod(methodName = "transactionLevelFees")})
 @UriParams
 @Configurer
 public final class ReportGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SettlementBatchSummaryGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SettlementBatchSummaryGatewayEndpointConfiguration.java
index ca3ed73..92c2d36 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SettlementBatchSummaryGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SettlementBatchSummaryGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.SettlementBatchSummaryGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.SettlementBatchSummaryGateway}.
  */
-@ApiParams(apiName = "settlementBatchSummary", apiMethods = {@ApiMethod(methodName = "generate")})
+@ApiParams(apiName = "settlementBatchSummary", description = "",
+           apiMethods = {@ApiMethod(methodName = "generate")})
 @UriParams
 @Configurer
 public final class SettlementBatchSummaryGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SubscriptionGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SubscriptionGatewayEndpointConfiguration.java
index e909623..8ae2c12 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SubscriptionGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/SubscriptionGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.SubscriptionGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.SubscriptionGateway}.
  */
-@ApiParams(apiName = "subscription", apiMethods = {@ApiMethod(methodName = "cancel"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "retryCharge"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "update")})
+@ApiParams(apiName = "subscription", description = "Provides methods to interact with Subscriptions",
+           apiMethods = {@ApiMethod(methodName = "cancel"), @ApiMethod(methodName = "create"), @ApiMethod(methodName = "delete"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "retryCharge"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "update")})
 @UriParams
 @Configurer
 public final class SubscriptionGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/TransactionGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/TransactionGatewayEndpointConfiguration.java
index ddc4f5a..0356b35 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/TransactionGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/TransactionGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.TransactionGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.TransactionGateway}.
  */
-@ApiParams(apiName = "transaction", apiMethods = {@ApiMethod(methodName = "cancelRelease"), @ApiMethod(methodName = "cloneTransaction"), @ApiMethod(methodName = "credit"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "holdInEscrow"), @ApiMethod(methodName = "refund"), @ApiMethod(methodName = "releaseFromEscrow"), @ApiMethod(methodName = "sale"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "submitForPartialSettlement"), @ApiMethod(methodName = "submitForSettleme [...]
+@ApiParams(apiName = "transaction", description = "Provides methods to interact with Transactions",
+           apiMethods = {@ApiMethod(methodName = "cancelRelease"), @ApiMethod(methodName = "cloneTransaction"), @ApiMethod(methodName = "credit"), @ApiMethod(methodName = "find"), @ApiMethod(methodName = "holdInEscrow"), @ApiMethod(methodName = "refund"), @ApiMethod(methodName = "releaseFromEscrow"), @ApiMethod(methodName = "sale"), @ApiMethod(methodName = "search"), @ApiMethod(methodName = "submitForPartialSettlement"), @ApiMethod(methodName = "submitForSettlement"), @ApiMethod(methodNa [...]
 @UriParams
 @Configurer
 public final class TransactionGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/WebhookNotificationGatewayEndpointConfiguration.java b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/WebhookNotificationGatewayEndpointConfiguration.java
index 5d0e81a..0440b3b 100644
--- a/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/WebhookNotificationGatewayEndpointConfiguration.java
+++ b/components/camel-braintree/src/generated/java/org/apache/camel/component/braintree/WebhookNotificationGatewayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.braintreegateway.WebhookNotificationGateway
+ * Camel endpoint configuration for {@link com.braintreegateway.WebhookNotificationGateway}.
  */
-@ApiParams(apiName = "webhookNotification", apiMethods = {@ApiMethod(methodName = "parse"), @ApiMethod(methodName = "verify")})
+@ApiParams(apiName = "webhookNotification", description = "",
+           apiMethods = {@ApiMethod(methodName = "parse"), @ApiMethod(methodName = "verify")})
 @UriParams
 @Configurer
 public final class WebhookNotificationGatewayEndpointConfiguration extends BraintreeConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AccountEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AccountEndpointConfiguration.java
index 712d7dd..33e5610 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AccountEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AccountEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.Account
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.Account}.
  */
-@ApiParams(apiName = "account", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "account", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class AccountEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressDependentPhoneNumberEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressDependentPhoneNumberEndpointConfiguration.java
index 711051c..90e2e13 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressDependentPhoneNumberEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressDependentPhoneNumberEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.address.DependentPhoneNumber
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.address.DependentPhoneNumber}.
  */
-@ApiParams(apiName = "address-dependent-phone-number", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "address-dependent-phone-number", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class AddressDependentPhoneNumberEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressEndpointConfiguration.java
index a8be6a9..29d82be 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AddressEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Address
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Address}.
  */
-@ApiParams(apiName = "address", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "address", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class AddressEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ApplicationEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ApplicationEndpointConfiguration.java
index 0a9a64d..eb0bf7a 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ApplicationEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ApplicationEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Application
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Application}.
  */
-@ApiParams(apiName = "application", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "application", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class ApplicationEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryEndpointConfiguration.java
index 7039538..d2948b1 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.AvailablePhoneNumberCountry
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.AvailablePhoneNumberCountry}.
  */
-@ApiParams(apiName = "available-phone-number-country", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "available-phone-number-country", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class AvailablePhoneNumberCountryEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryLocalEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryLocalEndpointConfiguration.java
index 532ade9..c836331 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryLocalEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryLocalEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.availablephonenumbercountry.Local
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.availablephonenumbercountry.Local}.
  */
-@ApiParams(apiName = "available-phone-number-country-local", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "available-phone-number-country-local", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class AvailablePhoneNumberCountryLocalEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryMobileEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryMobileEndpointConfiguration.java
index 4ca8465..1115c7d 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryMobileEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryMobileEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.availablephonenumbercountry.Mobile
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.availablephonenumbercountry.Mobile}.
  */
-@ApiParams(apiName = "available-phone-number-country-mobile", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "available-phone-number-country-mobile", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class AvailablePhoneNumberCountryMobileEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryTollFreeEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryTollFreeEndpointConfiguration.java
index 8afafcc..a817cb1 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryTollFreeEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/AvailablePhoneNumberCountryTollFreeEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.availablephonenumbercountry.TollFree
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.availablephonenumbercountry.TollFree}.
  */
-@ApiParams(apiName = "available-phone-number-country-toll-free", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "available-phone-number-country-toll-free", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class AvailablePhoneNumberCountryTollFreeEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallEndpointConfiguration.java
index 91e944c..87fd403 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Call
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Call}.
  */
-@ApiParams(apiName = "call", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "call", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class CallEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackEndpointConfiguration.java
index cda9829..438f5dc 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.call.Feedback
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.call.Feedback}.
  */
-@ApiParams(apiName = "call-feedback", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "call-feedback", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class CallFeedbackEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackSummaryEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackSummaryEndpointConfiguration.java
index 666307b..c2907d2 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackSummaryEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallFeedbackSummaryEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.call.FeedbackSummary
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.call.FeedbackSummary}.
  */
-@ApiParams(apiName = "call-feedback-summary", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher")})
+@ApiParams(apiName = "call-feedback-summary", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher")})
 @UriParams
 @Configurer
 public final class CallFeedbackSummaryEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallNotificationEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallNotificationEndpointConfiguration.java
index 5ba0100..f5cd3bc 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallNotificationEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallNotificationEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.call.Notification
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.call.Notification}.
  */
-@ApiParams(apiName = "call-notification", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "call-notification", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class CallNotificationEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallRecordingEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallRecordingEndpointConfiguration.java
index a33d5ce..99f7cfa 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallRecordingEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/CallRecordingEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.call.Recording
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.call.Recording}.
  */
-@ApiParams(apiName = "call-recording", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "call-recording", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class CallRecordingEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceEndpointConfiguration.java
index 2d297f8..ba0aac3 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Conference
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Conference}.
  */
-@ApiParams(apiName = "conference", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "conference", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class ConferenceEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceParticipantEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceParticipantEndpointConfiguration.java
index e0d0f0a..871e19d 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceParticipantEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConferenceParticipantEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.conference.Participant
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.conference.Participant}.
  */
-@ApiParams(apiName = "conference-participant", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "conference-participant", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class ConferenceParticipantEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConnectAppEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConnectAppEndpointConfiguration.java
index 322922f..d7f6723 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConnectAppEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ConnectAppEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.ConnectApp
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.ConnectApp}.
  */
-@ApiParams(apiName = "connect-app", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "connect-app", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class ConnectAppEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberEndpointConfiguration.java
index 59bb5e2..b69511c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.IncomingPhoneNumber
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.IncomingPhoneNumber}.
  */
-@ApiParams(apiName = "incoming-phone-number", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "incoming-phone-number", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class IncomingPhoneNumberEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberLocalEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberLocalEndpointConfiguration.java
index b39ab5b..4ba239c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberLocalEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberLocalEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.incomingphonenumber.Local
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.incomingphonenumber.Local}.
  */
-@ApiParams(apiName = "incoming-phone-number-local", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "incoming-phone-number-local", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class IncomingPhoneNumberLocalEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberMobileEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberMobileEndpointConfiguration.java
index ccef0a0..3bffd31 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberMobileEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberMobileEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.incomingphonenumber.Mobile
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.incomingphonenumber.Mobile}.
  */
-@ApiParams(apiName = "incoming-phone-number-mobile", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "incoming-phone-number-mobile", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class IncomingPhoneNumberMobileEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberTollFreeEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberTollFreeEndpointConfiguration.java
index b4e9d14..d1172ed 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberTollFreeEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/IncomingPhoneNumberTollFreeEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.incomingphonenumber.TollFree
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.incomingphonenumber.TollFree}.
  */
-@ApiParams(apiName = "incoming-phone-number-toll-free", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "incoming-phone-number-toll-free", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class IncomingPhoneNumberTollFreeEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/KeyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/KeyEndpointConfiguration.java
index 61fafa0..81a6284 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/KeyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/KeyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Key
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Key}.
  */
-@ApiParams(apiName = "key", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "key", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class KeyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageEndpointConfiguration.java
index b03682c..2e90b95 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Message
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Message}.
  */
-@ApiParams(apiName = "message", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "message", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class MessageEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageFeedbackEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageFeedbackEndpointConfiguration.java
index 37e3f30..c2c8e2c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageFeedbackEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageFeedbackEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.message.Feedback
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.message.Feedback}.
  */
-@ApiParams(apiName = "message-feedback", apiMethods = {@ApiMethod(methodName = "creator")})
+@ApiParams(apiName = "message-feedback", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator")})
 @UriParams
 @Configurer
 public final class MessageFeedbackEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageMediaEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageMediaEndpointConfiguration.java
index c8187d3..5716287 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageMediaEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/MessageMediaEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.message.Media
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.message.Media}.
  */
-@ApiParams(apiName = "message-media", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "message-media", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class MessageMediaEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewKeyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewKeyEndpointConfiguration.java
index da7aee3..b43584d 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewKeyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewKeyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.NewKey
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.NewKey}.
  */
-@ApiParams(apiName = "new-key", apiMethods = {@ApiMethod(methodName = "creator")})
+@ApiParams(apiName = "new-key", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator")})
 @UriParams
 @Configurer
 public final class NewKeyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewSigningKeyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewSigningKeyEndpointConfiguration.java
index 459b5d5..e15ca54 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewSigningKeyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NewSigningKeyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.NewSigningKey
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.NewSigningKey}.
  */
-@ApiParams(apiName = "new-signing-key", apiMethods = {@ApiMethod(methodName = "creator")})
+@ApiParams(apiName = "new-signing-key", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator")})
 @UriParams
 @Configurer
 public final class NewSigningKeyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NotificationEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NotificationEndpointConfiguration.java
index 646058a..c9eda55 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NotificationEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/NotificationEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Notification
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Notification}.
  */
-@ApiParams(apiName = "notification", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "notification", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class NotificationEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/OutgoingCallerIdEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/OutgoingCallerIdEndpointConfiguration.java
index 648ff13..988e8a8 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/OutgoingCallerIdEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/OutgoingCallerIdEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.OutgoingCallerId
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.OutgoingCallerId}.
  */
-@ApiParams(apiName = "outgoing-caller-id", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "outgoing-caller-id", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class OutgoingCallerIdEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueEndpointConfiguration.java
index 49b5c81..af8851c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Queue
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Queue}.
  */
-@ApiParams(apiName = "queue", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "queue", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class QueueEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueMemberEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueMemberEndpointConfiguration.java
index 9e5621e..8550929 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueMemberEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/QueueMemberEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.queue.Member
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.queue.Member}.
  */
-@ApiParams(apiName = "queue-member", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "queue-member", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class QueueMemberEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultEndpointConfiguration.java
index 48ee1e5..8ab8e5b 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.recording.AddOnResult
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.recording.AddOnResult}.
  */
-@ApiParams(apiName = "recording-add-on-result", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "recording-add-on-result", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class RecordingAddOnResultEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultPayloadEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultPayloadEndpointConfiguration.java
index 61a0c48..f2d8714 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultPayloadEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingAddOnResultPayloadEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.recording.addonresult.Payload
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.recording.addonresult.Payload}.
  */
-@ApiParams(apiName = "recording-add-on-result-payload", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "recording-add-on-result-payload", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class RecordingAddOnResultPayloadEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingEndpointConfiguration.java
index 1f5379d..888029c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Recording
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Recording}.
  */
-@ApiParams(apiName = "recording", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "recording", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class RecordingEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingTranscriptionEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingTranscriptionEndpointConfiguration.java
index 2a3e555..6dd66d8 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingTranscriptionEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/RecordingTranscriptionEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.recording.Transcription
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.recording.Transcription}.
  */
-@ApiParams(apiName = "recording-transcription", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "recording-transcription", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class RecordingTranscriptionEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ShortCodeEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ShortCodeEndpointConfiguration.java
index db51635..311e503 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ShortCodeEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ShortCodeEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.ShortCode
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.ShortCode}.
  */
-@ApiParams(apiName = "short-code", apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "short-code", description = "",
+           apiMethods = {@ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class ShortCodeEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SigningKeyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SigningKeyEndpointConfiguration.java
index 85b4910..7862ce9 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SigningKeyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SigningKeyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.SigningKey
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.SigningKey}.
  */
-@ApiParams(apiName = "signing-key", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "signing-key", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SigningKeyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialEndpointConfiguration.java
index 9951058..b793c4c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.credentiallist.Credential
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.credentiallist.Credential}.
  */
-@ApiParams(apiName = "sip-credential-list-credential", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "sip-credential-list-credential", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SipCredentialEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialListEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialListEndpointConfiguration.java
index eeb6b0e..eb73e1c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialListEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipCredentialListEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.CredentialList
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.CredentialList}.
  */
-@ApiParams(apiName = "sip-credential-list", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "sip-credential-list", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SipCredentialListEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainCredentialListMappingEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainCredentialListMappingEndpointConfiguration.java
index c58311e..cd4e2d3 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainCredentialListMappingEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainCredentialListMappingEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.domain.CredentialListMapping
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.domain.CredentialListMapping}.
  */
-@ApiParams(apiName = "sip-domain-credential-list-mapping", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "sip-domain-credential-list-mapping", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class SipDomainCredentialListMappingEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainEndpointConfiguration.java
index 788418d..5061a3b 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.Domain
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.Domain}.
  */
-@ApiParams(apiName = "sip-domain", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "sip-domain", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SipDomainEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainIpAccessControlListMappingEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainIpAccessControlListMappingEndpointConfiguration.java
index c0d0728..f1f8329 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainIpAccessControlListMappingEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipDomainIpAccessControlListMappingEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.domain.IpAccessControlListMapping
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.domain.IpAccessControlListMapping}.
  */
-@ApiParams(apiName = "sip-domain-ip-access-control-list-mapping", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "sip-domain-ip-access-control-list-mapping", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class SipDomainIpAccessControlListMappingEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListEndpointConfiguration.java
index ab9e591..f0b9205 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.IpAccessControlList
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.IpAccessControlList}.
  */
-@ApiParams(apiName = "sip-ip-access-control-list", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "sip-ip-access-control-list", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SipIpAccessControlListEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListIpAddressEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListIpAddressEndpointConfiguration.java
index 216347b..e97d08f 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListIpAddressEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/SipIpAccessControlListIpAddressEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.sip.ipaccesscontrollist.IpAddress
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.sip.ipaccesscontrollist.IpAddress}.
  */
-@ApiParams(apiName = "sip-ip-access-control-list-ip-address", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "sip-ip-access-control-list-ip-address", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class SipIpAccessControlListIpAddressEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TokenEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TokenEndpointConfiguration.java
index 180c256..c9a6e83 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TokenEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TokenEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Token
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Token}.
  */
-@ApiParams(apiName = "token", apiMethods = {@ApiMethod(methodName = "creator")})
+@ApiParams(apiName = "token", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator")})
 @UriParams
 @Configurer
 public final class TokenEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TranscriptionEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TranscriptionEndpointConfiguration.java
index f261e40..5289304 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TranscriptionEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/TranscriptionEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.Transcription
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.Transcription}.
  */
-@ApiParams(apiName = "transcription", apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "transcription", description = "",
+           apiMethods = {@ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class TranscriptionEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordAllTimeEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordAllTimeEndpointConfiguration.java
index 6b7af30..d0404b4 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordAllTimeEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordAllTimeEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.AllTime
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.AllTime}.
  */
-@ApiParams(apiName = "usage-record-all-time", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-all-time", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordAllTimeEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordDailyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordDailyEndpointConfiguration.java
index 7e76b1f..4b48c90 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordDailyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordDailyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.Daily
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.Daily}.
  */
-@ApiParams(apiName = "usage-record-daily", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-daily", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordDailyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordEndpointConfiguration.java
index e4cb01d..d9486cf 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.Record
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.Record}.
  */
-@ApiParams(apiName = "usage-record", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordLastMonthEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordLastMonthEndpointConfiguration.java
index 646ef2e..35ec465 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordLastMonthEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordLastMonthEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.LastMonth
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.LastMonth}.
  */
-@ApiParams(apiName = "usage-record-last-month", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-last-month", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordLastMonthEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordMonthlyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordMonthlyEndpointConfiguration.java
index 48a4d98..076436e 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordMonthlyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordMonthlyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.Monthly
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.Monthly}.
  */
-@ApiParams(apiName = "usage-record-monthly", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-monthly", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordMonthlyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordThisMonthEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordThisMonthEndpointConfiguration.java
index d92d485..0656b71 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordThisMonthEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordThisMonthEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.ThisMonth
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.ThisMonth}.
  */
-@ApiParams(apiName = "usage-record-this-month", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-this-month", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordThisMonthEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordTodayEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordTodayEndpointConfiguration.java
index 3efc50ee..1dc7d52 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordTodayEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordTodayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.Today
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.Today}.
  */
-@ApiParams(apiName = "usage-record-today", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-today", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordTodayEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYearlyEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYearlyEndpointConfiguration.java
index 41e6c78..d730b18 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYearlyEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYearlyEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.Yearly
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.Yearly}.
  */
-@ApiParams(apiName = "usage-record-yearly", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-yearly", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordYearlyEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYesterdayEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYesterdayEndpointConfiguration.java
index 77d6d86..fd96709 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYesterdayEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageRecordYesterdayEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.record.Yesterday
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.record.Yesterday}.
  */
-@ApiParams(apiName = "usage-record-yesterday", apiMethods = {@ApiMethod(methodName = "reader")})
+@ApiParams(apiName = "usage-record-yesterday", description = "",
+           apiMethods = {@ApiMethod(methodName = "reader")})
 @UriParams
 @Configurer
 public final class UsageRecordYesterdayEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageTriggerEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageTriggerEndpointConfiguration.java
index 725fe5b..f8c080c 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageTriggerEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/UsageTriggerEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.usage.Trigger
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.usage.Trigger}.
  */
-@ApiParams(apiName = "usage-trigger", apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
+@ApiParams(apiName = "usage-trigger", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator"), @ApiMethod(methodName = "deleter"), @ApiMethod(methodName = "fetcher"), @ApiMethod(methodName = "reader"), @ApiMethod(methodName = "updater")})
 @UriParams
 @Configurer
 public final class UsageTriggerEndpointConfiguration extends TwilioConfiguration {
diff --git a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ValidationRequestEndpointConfiguration.java b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ValidationRequestEndpointConfiguration.java
index eeee575..7af17bc9 100644
--- a/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ValidationRequestEndpointConfiguration.java
+++ b/components/camel-twilio/src/generated/java/org/apache/camel/component/twilio/ValidationRequestEndpointConfiguration.java
@@ -12,9 +12,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for com.twilio.rest.api.v2010.account.ValidationRequest
+ * Camel endpoint configuration for {@link com.twilio.rest.api.v2010.account.ValidationRequest}.
  */
-@ApiParams(apiName = "validation-request", apiMethods = {@ApiMethod(methodName = "creator")})
+@ApiParams(apiName = "validation-request", description = "",
+           apiMethods = {@ApiMethod(methodName = "creator")})
 @UriParams
 @Configurer
 public final class ValidationRequestEndpointConfiguration extends TwilioConfiguration {
diff --git a/core/camel-api/src/generated/java/org/apache/camel/spi/ApiParams.java b/core/camel-api/src/generated/java/org/apache/camel/spi/ApiParams.java
index fdefc50..a9be59a 100644
--- a/core/camel-api/src/generated/java/org/apache/camel/spi/ApiParams.java
+++ b/core/camel-api/src/generated/java/org/apache/camel/spi/ApiParams.java
@@ -40,6 +40,13 @@ public @interface ApiParams {
     String apiName() default "";
 
     /**
+     * Returns a description of the API.
+     * <p/>
+     * This is used for documentation and tooling only.
+     */
+    String description() default "";
+
+    /**
      * The API methods that the API provides of this configuration class.
      */
     ApiMethod[] apiMethods();
diff --git a/tooling/camel-tooling-util/src/main/java/org/apache/camel/tooling/util/JavadocHelper.java b/tooling/camel-tooling-util/src/main/java/org/apache/camel/tooling/util/JavadocHelper.java
index dc465cd..2d821eb 100644
--- a/tooling/camel-tooling-util/src/main/java/org/apache/camel/tooling/util/JavadocHelper.java
+++ b/tooling/camel-tooling-util/src/main/java/org/apache/camel/tooling/util/JavadocHelper.java
@@ -89,9 +89,12 @@ public final class JavadocHelper {
         String s = sb.toString();
         // remove all XML tags
         s = s.replaceAll("<.*?>", "");
+        // remove @link inlined javadoc links which is special handled
+        s = s.replaceAll("\\{@link\\s\\w+\\s(\\w+)}", "$1");
+        s = s.replaceAll("\\{@link\\s([\\w]+)}", "$1");
         // remove all inlined javadoc links, eg such as {@link org.apache.camel.spi.Registry}
         // use #? to remove leading # in case its a local reference
-        s = s.replaceAll("\\{\\@\\w+\\s#?([\\w.#(\\d,)]+)\\}", "$1");
+        s = s.replaceAll("\\{@\\w+\\s#?([\\w.#(\\d,)]+)}", "$1");
 
         // create a new line
         StringBuilder cb = new StringBuilder();
diff --git a/tooling/camel-tooling-util/src/test/java/org/apache/camel/tooling/util/JavadocHelperTest.java b/tooling/camel-tooling-util/src/test/java/org/apache/camel/tooling/util/JavadocHelperTest.java
index 9473834..6e1698f 100644
--- a/tooling/camel-tooling-util/src/test/java/org/apache/camel/tooling/util/JavadocHelperTest.java
+++ b/tooling/camel-tooling-util/src/test/java/org/apache/camel/tooling/util/JavadocHelperTest.java
@@ -83,4 +83,20 @@ public class JavadocHelperTest {
         String out2 = JavadocHelper.sanitizeDescription(JAVADOC2, false);
         Assertions.assertEquals(EXPECTED_OUT2, out2);
     }
+
+    @Test
+    public void testSanitizeJavaDocLink() throws Exception {
+        String s = " * Provides methods to create, delete, find, and update {@link Customer}\n"
+                   + " * objects. This class does not need to be instantiated directly. Instead, use";
+        String s2 = JavadocHelper.sanitizeDescription(s, false);
+        Assertions.assertEquals(
+                "Provides methods to create, delete, find, and update Customer objects. This class does not need to be instantiated directly. Instead, use",
+                s2);
+
+        s = " * Provides methods to interact with {@link Transaction Transactions}.\n"
+            + " * E.g. sales, credits, refunds, searches, etc.\n";
+        String s3 = JavadocHelper.sanitizeDescription(s, false);
+        Assertions.assertEquals("Provides methods to interact with Transactions. E.g. sales, credits, refunds, searches, etc.",
+                s3);
+    }
 }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
index c3b09e4..8e2fa7e 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/AbstractApiMethodGeneratorMojo.java
@@ -53,6 +53,9 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
     @Parameter
     protected String apiName;
 
+    @Parameter
+    protected String apiDescription;
+
     /**
      * Method alias patterns for all APIs.
      */
@@ -88,6 +91,8 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
         Map<String, Map<String, String>> parameters = new HashMap<>();
         List<SignatureModel> data = getSignatureList();
         for (SignatureModel model : data) {
+            // we get the api description via the method signature (not ideal but that's the way of the old parser API)
+            this.apiDescription = model.getApiDescription();
             signatures.add(model.getSignature());
             String method = StringHelper.before(model.getSignature(), "(");
             if (method != null && method.contains(" ")) {
@@ -99,7 +104,6 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
         }
         parser.setSignatures(signatures);
         parser.setParameters(parameters);
-
         parser.setClassLoader(getProjectClassLoader());
 
         // parse signatures
@@ -185,6 +189,7 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
     private VelocityContext getEndpointContext(List<ApiMethodParser.ApiMethodModel> models) throws MojoExecutionException {
         VelocityContext context = getCommonContext(models);
         context.put("apiName", apiName);
+        context.put("apiDescription", apiDescription);
 
         // TODO: we should include alias information as well
 
@@ -373,6 +378,13 @@ public abstract class AbstractApiMethodGeneratorMojo extends AbstractApiMethodBa
         return apiName;
     }
 
+    public String getApiDescription(String apiDescription) {
+        if (apiDescription == null) {
+            return "";
+        }
+        return apiDescription;
+    }
+
     public String getApiMethods(List<String> methods) {
         StringBuilder sb = new StringBuilder();
         sb.append("{");
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiComponentGeneratorMojo.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiComponentGeneratorMojo.java
index f1f4044..0847af7 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiComponentGeneratorMojo.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiComponentGeneratorMojo.java
@@ -160,6 +160,7 @@ public class ApiComponentGeneratorMojo extends AbstractApiMethodBaseMojo {
         mojo.proxyClass = apiProxy.getProxyClass();
         mojo.classPrefix = apiProxy.getClassPrefix();
         mojo.apiName = apiProxy.getApiName();
+        mojo.apiDescription = apiProxy.getApiDescription();
     }
 
     private AbstractApiMethodGeneratorMojo getApiMethodGenerator(ApiProxy api) {
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiProxy.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiProxy.java
index c7f0778..5d00cd9 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiProxy.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/ApiProxy.java
@@ -29,6 +29,8 @@ public class ApiProxy {
 
     private String apiName;
 
+    private String apiDescription;
+
     private String proxyClass;
 
     private File fromSignatureFile;
@@ -59,6 +61,14 @@ public class ApiProxy {
         this.apiName = apiName;
     }
 
+    public String getApiDescription() {
+        return apiDescription;
+    }
+
+    public void setApiDescription(String apiDescription) {
+        this.apiDescription = apiDescription;
+    }
+
     public String getProxyClass() {
         return proxyClass;
     }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
index 3950b88..742c460 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceApiMethodGeneratorMojo.java
@@ -17,15 +17,12 @@
 package org.apache.camel.maven;
 
 import java.io.InputStream;
-import java.lang.reflect.Method;
-import java.lang.reflect.Modifier;
 import java.util.ArrayList;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.regex.Pattern;
 
-import org.apache.camel.support.component.ApiMethodParser;
 import org.apache.maven.plugin.MojoExecutionException;
 import org.apache.maven.plugins.annotations.LifecyclePhase;
 import org.apache.maven.plugins.annotations.Mojo;
@@ -45,7 +42,6 @@ public class JavaSourceApiMethodGeneratorMojo extends AbstractApiMethodGenerator
     }
 
     protected static final String DEFAULT_EXCLUDE_PACKAGES = "javax?\\.lang.*";
-    private static final Pattern RAW_ARGTYPES_PATTERN = Pattern.compile("\\s*([^<\\s,]+)\\s*(<[^>]+>)?\\s*,?");
 
     @Parameter(property = PREFIX + "excludePackages", defaultValue = DEFAULT_EXCLUDE_PACKAGES)
     protected String excludePackages;
@@ -116,6 +112,7 @@ public class JavaSourceApiMethodGeneratorMojo extends AbstractApiMethodGenerator
                         int leftBracket = method.indexOf('(');
                         String name = method.substring(whitespace + 1, leftBracket);
                         SignatureModel model = new SignatureModel();
+                        model.setApiDescription(parser.getApiDescription());
                         model.setSignature(method);
                         Map<String, String> params = parser.getParameters().get(name);
                         model.setParameters(params);
@@ -135,39 +132,4 @@ public class JavaSourceApiMethodGeneratorMojo extends AbstractApiMethodGenerator
         return new ArrayList<>(result.values());
     }
 
-    private String getResultType(Class<?> aClass, String name, String[] types) throws MojoExecutionException {
-        Class<?>[] argTypes = new Class<?>[types.length];
-        final ClassLoader classLoader = getProjectClassLoader();
-        for (int i = 0; i < types.length; i++) {
-            try {
-                try {
-                    argTypes[i] = ApiMethodParser.forName(types[i], classLoader);
-                } catch (ClassNotFoundException e) {
-                    throw new MojoExecutionException(e.getMessage(), e);
-                }
-            } catch (IllegalArgumentException e) {
-                throw new MojoExecutionException(e.getCause().getMessage(), e.getCause());
-            }
-        }
-
-        // return null for non-public methods, and for non-static methods if includeStaticMethods is null or false
-        String result = null;
-        try {
-            final Method method = aClass.getMethod(name, argTypes);
-            int modifiers = method.getModifiers();
-            if (!Modifier.isStatic(modifiers) || Boolean.TRUE.equals(includeStaticMethods)) {
-                result = method.getReturnType().getName();
-            }
-        } catch (NoSuchMethodException e) {
-            // could be a non-public method
-            try {
-                aClass.getDeclaredMethod(name, argTypes);
-            } catch (NoSuchMethodException e1) {
-                throw new MojoExecutionException(e1.getMessage(), e1);
-            }
-        }
-
-        return result;
-    }
-
 }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
index 643d98c..935e41f 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/JavaSourceParser.java
@@ -24,7 +24,9 @@ import java.util.List;
 import java.util.Map;
 import java.util.StringJoiner;
 
+import org.apache.camel.util.StringHelper;
 import org.jboss.forge.roaster.Roaster;
+import org.jboss.forge.roaster._shade.org.eclipse.jdt.core.dom.ASTNode;
 import org.jboss.forge.roaster.model.JavaDocTag;
 import org.jboss.forge.roaster.model.Type;
 import org.jboss.forge.roaster.model.source.JavaClassSource;
@@ -43,6 +45,7 @@ public class JavaSourceParser {
     private Map<String, String> methodText = new HashMap<>();
     private Map<String, Map<String, String>> parameters = new LinkedHashMap<>();
     private String errorMessage;
+    private String apiDescription;
 
     public synchronized void parse(InputStream in, String innerClass) throws Exception {
         JavaClassSource rootClazz = (JavaClassSource) Roaster.parse(in);
@@ -57,6 +60,16 @@ public class JavaSourceParser {
             }
         }
 
+        String doc = getClassJavadocRaw(clazz);
+        apiDescription = sanitizeJavaDocValue(doc, true);
+        if (apiDescription == null || apiDescription.isEmpty()) {
+            doc = getClassJavadocRaw(rootClazz);
+            apiDescription = sanitizeJavaDocValue(doc, true);
+        }
+        if (apiDescription != null && apiDescription.indexOf('.') > 0) {
+            apiDescription = StringHelper.before(apiDescription, ".");
+        }
+
         for (MethodSource ms : clazz.getMethods()) {
             // should not be constructor and must be public
             if (!ms.isPublic() || ms.isConstructor()) {
@@ -216,21 +229,43 @@ public class JavaSourceParser {
             String key = tag.getValue();
             if (key.startsWith(name)) {
                 String desc = key.substring(name.length());
-                desc = sanitizeJavaDocValue(desc);
+                desc = sanitizeJavaDocValue(desc, false);
                 return desc;
             }
         }
         return "";
     }
 
-    private static String sanitizeJavaDocValue(String desc) {
-        // remove leading - and whitespaces
+    /**
+     * Gets the class javadoc raw (incl line breaks and tags etc). The roaster API returns the javadoc with line breaks
+     * and others removed
+     */
+    private static String getClassJavadocRaw(JavaClassSource clazz) {
+        Object obj = clazz.getJavaDoc().getInternal();
+        ASTNode node = (ASTNode) obj;
+        int pos = node.getStartPosition();
+        int len = node.getLength();
+        if (pos > 0 && len > 0) {
+            String txt = clazz.toUnformattedString();
+            String doc = txt.substring(pos, pos + len);
+            return doc;
+        } else {
+            return null;
+        }
+    }
+
+    private static String sanitizeJavaDocValue(String desc, boolean summary) {
+        if (desc == null) {
+            return null;
+        }
+
+        // remove leading - or / and whitespaces
         desc = desc.trim();
-        while (desc.startsWith("-")) {
+        while (desc.startsWith("-") || desc.startsWith("/")) {
             desc = desc.substring(1);
             desc = desc.trim();
         }
-        desc = sanitizeDescription(desc, false);
+        desc = sanitizeDescription(desc, summary);
         if (desc != null && !desc.isEmpty()) {
             // upper case first letter
             char ch = desc.charAt(0);
@@ -264,6 +299,7 @@ public class JavaSourceParser {
         methodText.clear();
         parameters.clear();
         errorMessage = null;
+        apiDescription = null;
     }
 
     public String getErrorMessage() {
@@ -282,4 +318,8 @@ public class JavaSourceParser {
         return parameters;
     }
 
+    public String getApiDescription() {
+        return apiDescription;
+    }
+
 }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
index a085ae7..419cc14 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/java/org/apache/camel/maven/SignatureModel.java
@@ -23,9 +23,27 @@ import java.util.Map;
  */
 public class SignatureModel {
 
+    private String apiName;
+    private String apiDescription;
     private String signature;
     private Map<String, String> parameters;
 
+    public String getApiName() {
+        return apiName;
+    }
+
+    public void setApiName(String apiName) {
+        this.apiName = apiName;
+    }
+
+    public String getApiDescription() {
+        return apiDescription;
+    }
+
+    public void setApiDescription(String apiDescription) {
+        this.apiDescription = apiDescription;
+    }
+
     public String getSignature() {
         return signature;
     }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/main/resources/api-endpoint-config.vm b/tooling/maven/camel-api-component-maven-plugin/src/main/resources/api-endpoint-config.vm
index bfa64fe..2199044 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/main/resources/api-endpoint-config.vm
+++ b/tooling/maven/camel-api-component-maven-plugin/src/main/resources/api-endpoint-config.vm
@@ -44,9 +44,10 @@ import org.apache.camel.spi.UriParam;
 import org.apache.camel.spi.UriParams;
 
 /**
- * Camel EndpointConfiguration for $proxyType.Name
+ * Camel endpoint configuration for {@link $proxyType.Name}.
  */
-@ApiParams(apiName = "$helper.getApiName($apiName)", apiMethods = $helper.getApiMethods($apiMethods))
+@ApiParams(apiName = "$helper.getApiName($apiName)", description = "$helper.getApiDescription($apiDescription)",
+           apiMethods = $helper.getApiMethods($apiMethods))
 @UriParams
 @Configurer
 public final class $configName extends ${componentName}Configuration {
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/component/test/TestProxy.java b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/component/test/TestProxy.java
index 7234a11..8eede8e 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/component/test/TestProxy.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/component/test/TestProxy.java
@@ -20,6 +20,9 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * This is the test API.
+ */
 public class TestProxy {
 
     /**
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
index 2bad48b..63e16fa 100644
--- a/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
+++ b/tooling/maven/camel-api-component-maven-plugin/src/test/java/org/apache/camel/maven/JavaSourceParserTest.java
@@ -108,4 +108,20 @@ public class JavaSourceParserTest {
         parser.reset();
     }
 
+    @Test
+    public void testClassJavadoc() throws Exception {
+        final JavaSourceParser parser = new JavaSourceParser();
+
+        parser.parse(JavaSourceParserTest.class.getResourceAsStream("/DisputeGateway.java"), null);
+
+        String desc = parser.getApiDescription();
+        assertEquals("Provides methods to interact with Dispute objects", desc);
+
+        parser.reset();
+        parser.parse(JavaSourceParserTest.class.getResourceAsStream("/CustomGateway.java"), null);
+
+        desc = parser.getApiDescription();
+        assertEquals("Provides methods to create, delete, find, and update Customer objects", desc);
+    }
+
 }
diff --git a/tooling/maven/camel-api-component-maven-plugin/src/test/resources/CustomGateway.java b/tooling/maven/camel-api-component-maven-plugin/src/test/resources/CustomGateway.java
new file mode 100644
index 0000000..977d179
--- /dev/null
+++ b/tooling/maven/camel-api-component-maven-plugin/src/test/resources/CustomGateway.java
@@ -0,0 +1,156 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+//CHECKSTYLE:OFF
+package com.braintreegateway;
+
+import com.braintreegateway.exceptions.NotFoundException;
+import com.braintreegateway.util.Http;
+import com.braintreegateway.util.NodeWrapper;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Provides methods to create, delete, find, and update {@link Customer}
+ * objects. This class does not need to be instantiated directly. Instead, use
+ * {@link BraintreeGateway#customer()} to get an instance of this class:
+ *
+ * <pre>
+ * BraintreeGateway gateway = new BraintreeGateway(...);
+ * gateway.customer().create(...)
+ * </pre>
+ *
+ * For more detailed information on {@link Customer Customers}, see <a href="https://developers.braintreepayments.com/reference/response/customer/java" target="_blank">https://developers.braintreepayments.com/reference/response/customer/java</a>
+ */
+public class CustomerGateway {
+    private Configuration configuration;
+    private Http http;
+
+    public CustomerGateway(Http http, Configuration configuration) {
+        this.configuration = configuration;
+        this.http = http;
+    }
+
+    /**
+     * Finds all Customers and returns a {@link ResourceCollection}.
+     *
+     * @return a {@link ResourceCollection}.
+     */
+    public ResourceCollection<Customer> all() {
+        NodeWrapper response = http.post(configuration.getMerchantPath() + "/customers/advanced_search_ids");
+        return new ResourceCollection<Customer>(new CustomerPager(this, new CustomerSearchRequest()), response);
+    }
+
+    List<Customer> fetchCustomers(CustomerSearchRequest query, List<String> ids) {
+        query.ids().in(ids);
+        NodeWrapper response = http.post(configuration.getMerchantPath() + "/customers/advanced_search", query);
+
+        List<Customer> items = new ArrayList<Customer>();
+        for (NodeWrapper node : response.findAll("customer")) {
+            items.add(new Customer(node));
+        }
+
+        return items;
+    }
+
+    /**
+     * Creates a {@link Customer}.
+     *
+     * @param request
+     *            the request.
+     * @return a {@link Result}.
+     */
+    public Result<Customer> create(CustomerRequest request) {
+        NodeWrapper node = http.post(configuration.getMerchantPath() + "/customers", request);
+        return new Result<Customer>(node, Customer.class);
+    }
+
+    /**
+     * Deletes a {@link Customer} by id.
+     *
+     * @param id
+     *            the id of the {@link Customer}.
+     * @return a {@link Result}.
+     */
+    public Result<Customer> delete(String id) {
+        http.delete(configuration.getMerchantPath() + "/customers/" + id);
+        return new Result<Customer>();
+    }
+
+    /**
+     * Finds a {@link Customer} by id.
+     *
+     * @param id
+     *            the id of the {@link Customer}.
+     * @return the {@link Customer} or raises a
+     *         {@link com.braintreegateway.exceptions.NotFoundException}.
+     */
+    public Customer find(String id) {
+        if(id == null || id.trim().equals(""))
+            throw new NotFoundException();
+
+        return new Customer(http.get(configuration.getMerchantPath() + "/customers/" + id));
+    }
+
+    /**
+     * Finds a {@link Customer} by id.
+     *
+     * @param id
+     *            the id of the {@link Customer}.
+     * @param associationFilterId
+     *            the id of the association filter to use.
+     * @return the {@link Customer} or raises a
+     *         {@link com.braintreegateway.exceptions.NotFoundException}.
+     */
+    public Customer find(String id, String associationFilterId) {
+        if(id == null || id.trim().equals(""))
+            throw new NotFoundException();
+
+        if(associationFilterId == null || associationFilterId.isEmpty())
+            throw new NotFoundException();
+
+        String queryParams = "?association_filter_id=" + associationFilterId;
+        return new Customer(http.get(configuration.getMerchantPath() + "/customers/" + id + queryParams));
+    }
+
+    /**
+     * Finds all Transactions that match the query and returns a {@link ResourceCollection}.
+     * See: <a href="https://developers.braintreepayments.com/reference/request/transaction/search/java" target="_blank">https://developers.braintreepayments.com/reference/request/transaction/search/java</a>
+     * @param query the request query to use for search
+     * @return a {@link ResourceCollection}.
+     */
+    public ResourceCollection<Customer> search(CustomerSearchRequest query) {
+        NodeWrapper node = http.post(configuration.getMerchantPath() + "/customers/advanced_search_ids", query);
+        return new ResourceCollection<Customer>(new CustomerPager(this, query), node);
+    }
+
+    /**
+     * Updates a {@link Customer}.
+     *
+     * @param id
+     *            the id of the {@link Customer}.
+     * @param request
+     *            the request.
+     * @return a {@link Result}.
+     */
+    public Result<Customer> update(String id, CustomerRequest request) {
+        NodeWrapper node = http.put(configuration.getMerchantPath() + "/customers/" + id, request);
+        return new Result<Customer>(node, Customer.class);
+    }
+
+}
+//CHECKSTYLE:ON
\ No newline at end of file
diff --git a/tooling/spi-annotations/src/main/java/org/apache/camel/spi/ApiParams.java b/tooling/spi-annotations/src/main/java/org/apache/camel/spi/ApiParams.java
index fdefc50..a9be59a 100644
--- a/tooling/spi-annotations/src/main/java/org/apache/camel/spi/ApiParams.java
+++ b/tooling/spi-annotations/src/main/java/org/apache/camel/spi/ApiParams.java
@@ -40,6 +40,13 @@ public @interface ApiParams {
     String apiName() default "";
 
     /**
+     * Returns a description of the API.
+     * <p/>
+     * This is used for documentation and tooling only.
+     */
+    String description() default "";
+
+    /**
      * The API methods that the API provides of this configuration class.
      */
     ApiMethod[] apiMethods();