@idunion/tl-sdk 0.0.59 → 0.0.61

package/api.js

@@ -3,7 +3,7 @@
 /* eslint-disable */
 /**
  * IDUnion Trust List API
- * IDUnion Trust List API
+ * The IDUnion Trust List API provides a backend for managing decentralized trust infrastructure based on ETSI TS 119-602 and TS 119-612 standards. It enables creation and management of Trust Lists (TLs) and Trust List Records (TLRs), DID document management, credential-based onboarding of organizations, and export of standards-compliant trust list XML documents.  Trust Lists group organizations (Trust List Records) by their role in the ecosystem, such as Wallet Providers, PID Providers, or QEAA Providers. Each organization is represented by a W3C Decentralized Identifier (DID) with associated cryptographic verification methods.
  *
  * The version of the OpenAPI document: 0.0.1
  *
@@ -43,7 +43,7 @@ exports.OnboardingStatusStatusEnum = {
     Error: 'error'
 };
 /**
- * Trust List type
+ * Defines the role category of entities registered in the Trust List, aligned with ETSI TS 119-602 and the EU Digital Identity (EUDI) framework:   - `QEAA_Provider`: Qualified Electronic Attestation of Attributes provider   - `PuBEAA_Provider`: Public Body Electronic Attestation of Attributes provider   - `Wallet_Provider`: EUDI-compliant identity wallet solution provider   - `PID_Provider`: Person Identification Data provider (e.g. national eID issuer)   - `Access_Certificate_Authority`: Issuer of access certificates for wallet interactions   - `Registration_Certificates_Provider`: Issuer of registration certificates   - `EAA_Provider`: Electronic Attestation of Attributes provider (non-qualified)
  */
 exports.TlType = {
     QeaaProvider: 'QEAA_Provider',
@@ -66,7 +66,7 @@ exports.TlrStatusEnum = {
 const DefaultApiAxiosParamCreator = function (configuration) {
     return {
         /**
-         * Retrieves a specific DID Document
+         * Returns the W3C DID Document for the specified Trust List Record. The document contains the entity\'s DID, cryptographic verification methods, and service endpoints. This endpoint follows the `did:web` resolution convention and is used by DID resolvers to look up the entity\'s public key material and service information.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -99,7 +99,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Suggests a DID
+         * Returns a suggested DID for a new Trust List Record within the specified Trust List. The suggested DID is derived from the Trust List\'s DID base and can be used to pre-fill the DID field when creating a new record.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -131,10 +131,10 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Adds DID Verification method.
+         * Adds a new verification method to the DID Document of the specified Trust List Record. The verification method includes cryptographic key material (e.g. Ed25519, RSA, or ES256K) and is registered under the assertionMethod, authentication, and capabilityInvocation relationships in the DID Document.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method.
+         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method to add, including its type, controller DID, key ID, and key material.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -170,10 +170,10 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Adds DID Verification method.
+         * Updates an existing verification method on the DID Document of a Trust List Record. Primarily used to revoke a verification method by setting the `revoked` timestamp, which marks the key as no longer valid and transitions the Trust List Record status to `revoked`. The Trust List Record\'s status in the ETSI trust list XML is updated accordingly.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Verification method.
+         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Partial verification method update payload. Provide the key ID and the fields to update, such as the `revoked` timestamp to revoke the key.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -209,7 +209,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Returns an ETSI 119 602 Trusted list
+         * Returns the Trust List in ETSI TS 119-602 XML format, which defines the standard for trust frameworks of identity wallet ecosystems (e.g. EUDI Wallet). The XML document includes Trust List Records with their DID-based cryptographic material and accreditation information, suitable for consumption by wallet verifiers and trust framework participants.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -241,7 +241,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Returns an ETSI 119 612 Trusted list
+         * Returns the Trust List in ETSI TS 119-612 XML format, which defines the standard for Trusted Lists of Trust Service Providers (TSPs) in the context of electronic signatures and qualified trust services. The XML document includes all active, onboarded, and revoked Trust List Records with their x509 certificates and service status information, suitable for consumption by conformant trust service validators.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -273,7 +273,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         *
+         * Returns the operational health status of the Trust List API service. Useful for monitoring, load balancer checks, and readiness probes.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -298,9 +298,9 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Initiates the onboarding process to the DID registry.
+         * Initiates the credential-based onboarding process for an organization joining the specified Trust List. Returns a verifier URL to redirect the holder to, where they must present an onboarding Verifiable Credential (VC) proving their eligibility. After presenting the credential, the status can be polled via `GET /onboarding/{verifier_state}`. On successful verification, a Trust List Record is automatically created for the organization.
          * @param {string} tlId Trust List identifier
-         * @param {OnboardingPayload} [onboardingPayload] DID onboarding init payload.
+         * @param {OnboardingPayload} [onboardingPayload] Onboarding initiation payload specifying the verifier to use and optionally the holder\'s entity identifier (did:key).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -330,7 +330,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         *
+         * Polls the status of an ongoing onboarding process using the verifier state token returned by `POST /{tl_id}/onboarding`. Returns the current status (`in_progress`, `completed`, or `error`) along with the assigned DID once onboarding is complete. Clients should poll this endpoint periodically until a terminal status is reached.
          * @param {string} verifierState Verifier state
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -359,8 +359,8 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Creates a Trust List based on the specified payload.
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * Creates a new Trust List owned by the authenticated user. A Trust List groups organizations (Trust List Records) of a specific role type (e.g. Wallet Provider, PID Provider). It requires a governance wallet for VC interactions and a verifier to validate onboarding credentials presented by joining organizations.
+         * @param {TlPayload} [tlPayload] Trust List create payload including name, type, description, and references to the governance wallet and verifier services.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -390,7 +390,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Destroys the Trust List.
+         * Permanently deletes the specified Trust List and all its associated records. Only the Trust List owner can perform this operation.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -422,7 +422,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Gets the specified Trust List
+         * Returns the full representation of a specific Trust List for the authenticated owner, including the verifier ID not exposed in the public directory endpoints.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -454,7 +454,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Provides a public information about a specific Trusted List
+         * Returns publicly accessible metadata for a specific Trust List. No authentication is required. Returns the same fields as the directory listing but for a single Trust List, excluding sensitive fields such as the verifier ID.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -483,7 +483,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Provides a list of public Trusted Lists
+         * Returns a publicly accessible directory of all Trust Lists. No authentication is required. An optional `search` query parameter filters results by name or description. Used by clients to display a browseable catalog of available trust ecosystems.
          * @param {string} [search]
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -512,7 +512,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Provides a list of Trusted Lists for an authenticated owner
+         * Returns all Trust Lists owned by the authenticated user. Unlike the public directory, this response includes the full Trust List representation with the verifier ID. Used to populate the authenticated user\'s management dashboard.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -540,9 +540,9 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Updates a Trust List based on the specified payload.
+         * Updates the metadata of an existing Trust List. Only the Trust List owner can perform this operation. Fields provided in the payload will overwrite current values.
          * @param {string} tlId
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * @param {TlPayload} [tlPayload] Trust List update payload. Provide only the fields to update.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -575,9 +575,9 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Directly creates a new Trusted List Record. When a Certificate Signing Request is provided, it will also issue an x509 certificate and update the ETSI TS 119 6**
+         * Directly creates a new Trust List Record in the specified Trust List, bypassing the credential-based onboarding flow. The public key material must be provided either as a `did:key` or a Certificate Signing Request (CSR) in PEM format. When a CSR is provided, the API issues an x509 certificate and registers it in the ETSI TS 119-612 trust list XML. Returns the generated DID and, if a CSR was provided, the issued certificate.
          * @param {string} tlId
-         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record Create Payload.
+         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record create payload. Includes organization details and either a did:key or a CSR for key material provisioning.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -610,7 +610,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Removes a specific Trust List Record
+         * Permanently removes a specific Trust List Record from the Trust List. Only the Trust List owner can perform this operation. The associated DID Document and all related data will be deleted.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -646,7 +646,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Retrieves a specific Trust List record
+         * Returns a specific Trust List Record including organization details, DID, current status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. No authentication is required; used to display public entity detail pages.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -679,7 +679,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Retrieves a list of Trust List Records.
+         * Searches for Trust List Records across all Trust Lists by organization name. No authentication is required. Used by public-facing directory or search features to find entities registered under a given organization name.
          * @param {string} orgName
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -708,7 +708,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Gets Trust List Records that make up a single Trust Chain
+         * Returns the full chain of Trust List Records from the root trust anchor down to the specified record. Each element in the array represents one step in the chain of trust, showing which entities issued or accredited the next. Used to visualize and verify the complete trust path for a given organization.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -741,7 +741,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Retrieves a list of Trust List records.
+         * Returns all Trust List Records belonging to a specific Trust List. Each record represents an organization with its DID, status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. Used to display the list of entities participating in a trust ecosystem.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -773,7 +773,7 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Gets a Verifiable Presentation.
+         * Retrieves the Verifiable Presentation (VP) stored for a specific Trust List Record. The VP is encoded as a JWT and represents the credential presented during the onboarding process, proving the entity\'s eligibility to join the Trust List. Used to audit or display the onboarding evidence for a given record.
          * @param {string} tlId
          * @param {string} did
          * @param {string} id
@@ -822,7 +822,7 @@ const DefaultApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.DefaultApiAxiosParamCreator)(configuration);
     return {
         /**
-         * Retrieves a specific DID Document
+         * Returns the W3C DID Document for the specified Trust List Record. The document contains the entity\'s DID, cryptographic verification methods, and service endpoints. This endpoint follows the `did:web` resolution convention and is used by DID resolvers to look up the entity\'s public key material and service information.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -838,7 +838,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Suggests a DID
+         * Returns a suggested DID for a new Trust List Record within the specified Trust List. The suggested DID is derived from the Trust List\'s DID base and can be used to pre-fill the DID field when creating a new record.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -853,10 +853,10 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Adds DID Verification method.
+         * Adds a new verification method to the DID Document of the specified Trust List Record. The verification method includes cryptographic key material (e.g. Ed25519, RSA, or ES256K) and is registered under the assertionMethod, authentication, and capabilityInvocation relationships in the DID Document.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method.
+         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method to add, including its type, controller DID, key ID, and key material.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -870,10 +870,10 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Adds DID Verification method.
+         * Updates an existing verification method on the DID Document of a Trust List Record. Primarily used to revoke a verification method by setting the `revoked` timestamp, which marks the key as no longer valid and transitions the Trust List Record status to `revoked`. The Trust List Record\'s status in the ETSI trust list XML is updated accordingly.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Verification method.
+         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Partial verification method update payload. Provide the key ID and the fields to update, such as the `revoked` timestamp to revoke the key.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -887,7 +887,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Returns an ETSI 119 602 Trusted list
+         * Returns the Trust List in ETSI TS 119-602 XML format, which defines the standard for trust frameworks of identity wallet ecosystems (e.g. EUDI Wallet). The XML document includes Trust List Records with their DID-based cryptographic material and accreditation information, suitable for consumption by wallet verifiers and trust framework participants.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -902,7 +902,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Returns an ETSI 119 612 Trusted list
+         * Returns the Trust List in ETSI TS 119-612 XML format, which defines the standard for Trusted Lists of Trust Service Providers (TSPs) in the context of electronic signatures and qualified trust services. The XML document includes all active, onboarded, and revoked Trust List Records with their x509 certificates and service status information, suitable for consumption by conformant trust service validators.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -917,7 +917,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         *
+         * Returns the operational health status of the Trust List API service. Useful for monitoring, load balancer checks, and readiness probes.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -931,9 +931,9 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Initiates the onboarding process to the DID registry.
+         * Initiates the credential-based onboarding process for an organization joining the specified Trust List. Returns a verifier URL to redirect the holder to, where they must present an onboarding Verifiable Credential (VC) proving their eligibility. After presenting the credential, the status can be polled via `GET /onboarding/{verifier_state}`. On successful verification, a Trust List Record is automatically created for the organization.
          * @param {string} tlId Trust List identifier
-         * @param {OnboardingPayload} [onboardingPayload] DID onboarding init payload.
+         * @param {OnboardingPayload} [onboardingPayload] Onboarding initiation payload specifying the verifier to use and optionally the holder\'s entity identifier (did:key).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -947,7 +947,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         *
+         * Polls the status of an ongoing onboarding process using the verifier state token returned by `POST /{tl_id}/onboarding`. Returns the current status (`in_progress`, `completed`, or `error`) along with the assigned DID once onboarding is complete. Clients should poll this endpoint periodically until a terminal status is reached.
          * @param {string} verifierState Verifier state
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -962,8 +962,8 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Creates a Trust List based on the specified payload.
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * Creates a new Trust List owned by the authenticated user. A Trust List groups organizations (Trust List Records) of a specific role type (e.g. Wallet Provider, PID Provider). It requires a governance wallet for VC interactions and a verifier to validate onboarding credentials presented by joining organizations.
+         * @param {TlPayload} [tlPayload] Trust List create payload including name, type, description, and references to the governance wallet and verifier services.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -977,7 +977,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Destroys the Trust List.
+         * Permanently deletes the specified Trust List and all its associated records. Only the Trust List owner can perform this operation.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -992,7 +992,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Gets the specified Trust List
+         * Returns the full representation of a specific Trust List for the authenticated owner, including the verifier ID not exposed in the public directory endpoints.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1007,7 +1007,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Provides a public information about a specific Trusted List
+         * Returns publicly accessible metadata for a specific Trust List. No authentication is required. Returns the same fields as the directory listing but for a single Trust List, excluding sensitive fields such as the verifier ID.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1022,7 +1022,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Provides a list of public Trusted Lists
+         * Returns a publicly accessible directory of all Trust Lists. No authentication is required. An optional `search` query parameter filters results by name or description. Used by clients to display a browseable catalog of available trust ecosystems.
          * @param {string} [search]
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1037,7 +1037,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Provides a list of Trusted Lists for an authenticated owner
+         * Returns all Trust Lists owned by the authenticated user. Unlike the public directory, this response includes the full Trust List representation with the verifier ID. Used to populate the authenticated user\'s management dashboard.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1051,9 +1051,9 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Updates a Trust List based on the specified payload.
+         * Updates the metadata of an existing Trust List. Only the Trust List owner can perform this operation. Fields provided in the payload will overwrite current values.
          * @param {string} tlId
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * @param {TlPayload} [tlPayload] Trust List update payload. Provide only the fields to update.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1067,9 +1067,9 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Directly creates a new Trusted List Record. When a Certificate Signing Request is provided, it will also issue an x509 certificate and update the ETSI TS 119 6**
+         * Directly creates a new Trust List Record in the specified Trust List, bypassing the credential-based onboarding flow. The public key material must be provided either as a `did:key` or a Certificate Signing Request (CSR) in PEM format. When a CSR is provided, the API issues an x509 certificate and registers it in the ETSI TS 119-612 trust list XML. Returns the generated DID and, if a CSR was provided, the issued certificate.
          * @param {string} tlId
-         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record Create Payload.
+         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record create payload. Includes organization details and either a did:key or a CSR for key material provisioning.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1083,7 +1083,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Removes a specific Trust List Record
+         * Permanently removes a specific Trust List Record from the Trust List. Only the Trust List owner can perform this operation. The associated DID Document and all related data will be deleted.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1099,7 +1099,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Retrieves a specific Trust List record
+         * Returns a specific Trust List Record including organization details, DID, current status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. No authentication is required; used to display public entity detail pages.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1115,7 +1115,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Retrieves a list of Trust List Records.
+         * Searches for Trust List Records across all Trust Lists by organization name. No authentication is required. Used by public-facing directory or search features to find entities registered under a given organization name.
          * @param {string} orgName
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1130,7 +1130,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Gets Trust List Records that make up a single Trust Chain
+         * Returns the full chain of Trust List Records from the root trust anchor down to the specified record. Each element in the array represents one step in the chain of trust, showing which entities issued or accredited the next. Used to visualize and verify the complete trust path for a given organization.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1146,7 +1146,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Retrieves a list of Trust List records.
+         * Returns all Trust List Records belonging to a specific Trust List. Each record represents an organization with its DID, status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. Used to display the list of entities participating in a trust ecosystem.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1161,7 +1161,7 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Gets a Verifiable Presentation.
+         * Retrieves the Verifiable Presentation (VP) stored for a specific Trust List Record. The VP is encoded as a JWT and represents the credential presented during the onboarding process, proving the entity\'s eligibility to join the Trust List. Used to audit or display the onboarding evidence for a given record.
          * @param {string} tlId
          * @param {string} did
          * @param {string} id
@@ -1187,7 +1187,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.DefaultApiFp)(configuration);
     return {
         /**
-         * Retrieves a specific DID Document
+         * Returns the W3C DID Document for the specified Trust List Record. The document contains the entity\'s DID, cryptographic verification methods, and service endpoints. This endpoint follows the `did:web` resolution convention and is used by DID resolvers to look up the entity\'s public key material and service information.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1197,7 +1197,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.didGet(tlId, tlrId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Suggests a DID
+         * Returns a suggested DID for a new Trust List Record within the specified Trust List. The suggested DID is derived from the Trust List\'s DID base and can be used to pre-fill the DID field when creating a new record.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1206,10 +1206,10 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.didSuggest(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Adds DID Verification method.
+         * Adds a new verification method to the DID Document of the specified Trust List Record. The verification method includes cryptographic key material (e.g. Ed25519, RSA, or ES256K) and is registered under the assertionMethod, authentication, and capabilityInvocation relationships in the DID Document.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method.
+         * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method to add, including its type, controller DID, key ID, and key material.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1217,10 +1217,10 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.didVerificationMethodAdd(tlId, tlrId, verificationMethodCreatePayload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Adds DID Verification method.
+         * Updates an existing verification method on the DID Document of a Trust List Record. Primarily used to revoke a verification method by setting the `revoked` timestamp, which marks the key as no longer valid and transitions the Trust List Record status to `revoked`. The Trust List Record\'s status in the ETSI trust list XML is updated accordingly.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
-         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Verification method.
+         * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Partial verification method update payload. Provide the key ID and the fields to update, such as the `revoked` timestamp to revoke the key.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1228,7 +1228,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.didVerificationMethodPatch(tlId, tlrId, verificationMethodPatchPayload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Returns an ETSI 119 602 Trusted list
+         * Returns the Trust List in ETSI TS 119-602 XML format, which defines the standard for trust frameworks of identity wallet ecosystems (e.g. EUDI Wallet). The XML document includes Trust List Records with their DID-based cryptographic material and accreditation information, suitable for consumption by wallet verifiers and trust framework participants.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1237,7 +1237,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.etsiTl602Get(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Returns an ETSI 119 612 Trusted list
+         * Returns the Trust List in ETSI TS 119-612 XML format, which defines the standard for Trusted Lists of Trust Service Providers (TSPs) in the context of electronic signatures and qualified trust services. The XML document includes all active, onboarded, and revoked Trust List Records with their x509 certificates and service status information, suitable for consumption by conformant trust service validators.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1246,7 +1246,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.etsiTl612Get(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         *
+         * Returns the operational health status of the Trust List API service. Useful for monitoring, load balancer checks, and readiness probes.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1254,9 +1254,9 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.healthCheck(options).then((request) => request(axios, basePath));
         },
         /**
-         * Initiates the onboarding process to the DID registry.
+         * Initiates the credential-based onboarding process for an organization joining the specified Trust List. Returns a verifier URL to redirect the holder to, where they must present an onboarding Verifiable Credential (VC) proving their eligibility. After presenting the credential, the status can be polled via `GET /onboarding/{verifier_state}`. On successful verification, a Trust List Record is automatically created for the organization.
          * @param {string} tlId Trust List identifier
-         * @param {OnboardingPayload} [onboardingPayload] DID onboarding init payload.
+         * @param {OnboardingPayload} [onboardingPayload] Onboarding initiation payload specifying the verifier to use and optionally the holder\'s entity identifier (did:key).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1264,7 +1264,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.onboardingInit(tlId, onboardingPayload, options).then((request) => request(axios, basePath));
         },
         /**
-         *
+         * Polls the status of an ongoing onboarding process using the verifier state token returned by `POST /{tl_id}/onboarding`. Returns the current status (`in_progress`, `completed`, or `error`) along with the assigned DID once onboarding is complete. Clients should poll this endpoint periodically until a terminal status is reached.
          * @param {string} verifierState Verifier state
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1273,8 +1273,8 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.onboardingStatus(verifierState, options).then((request) => request(axios, basePath));
         },
         /**
-         * Creates a Trust List based on the specified payload.
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * Creates a new Trust List owned by the authenticated user. A Trust List groups organizations (Trust List Records) of a specific role type (e.g. Wallet Provider, PID Provider). It requires a governance wallet for VC interactions and a verifier to validate onboarding credentials presented by joining organizations.
+         * @param {TlPayload} [tlPayload] Trust List create payload including name, type, description, and references to the governance wallet and verifier services.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1282,7 +1282,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlCreate(tlPayload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Destroys the Trust List.
+         * Permanently deletes the specified Trust List and all its associated records. Only the Trust List owner can perform this operation.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1291,7 +1291,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlDelete(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Gets the specified Trust List
+         * Returns the full representation of a specific Trust List for the authenticated owner, including the verifier ID not exposed in the public directory endpoints.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1300,7 +1300,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlGet(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Provides a public information about a specific Trusted List
+         * Returns publicly accessible metadata for a specific Trust List. No authentication is required. Returns the same fields as the directory listing but for a single Trust List, excluding sensitive fields such as the verifier ID.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1309,7 +1309,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlGetPublicInfo(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Provides a list of public Trusted Lists
+         * Returns a publicly accessible directory of all Trust Lists. No authentication is required. An optional `search` query parameter filters results by name or description. Used by clients to display a browseable catalog of available trust ecosystems.
          * @param {string} [search]
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1318,7 +1318,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlList(search, options).then((request) => request(axios, basePath));
         },
         /**
-         * Provides a list of Trusted Lists for an authenticated owner
+         * Returns all Trust Lists owned by the authenticated user. Unlike the public directory, this response includes the full Trust List representation with the verifier ID. Used to populate the authenticated user\'s management dashboard.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1326,9 +1326,9 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlListByOwner(options).then((request) => request(axios, basePath));
         },
         /**
-         * Updates a Trust List based on the specified payload.
+         * Updates the metadata of an existing Trust List. Only the Trust List owner can perform this operation. Fields provided in the payload will overwrite current values.
          * @param {string} tlId
-         * @param {TlPayload} [tlPayload] Trust List create payload.
+         * @param {TlPayload} [tlPayload] Trust List update payload. Provide only the fields to update.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1336,9 +1336,9 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlPatch(tlId, tlPayload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Directly creates a new Trusted List Record. When a Certificate Signing Request is provided, it will also issue an x509 certificate and update the ETSI TS 119 6**
+         * Directly creates a new Trust List Record in the specified Trust List, bypassing the credential-based onboarding flow. The public key material must be provided either as a `did:key` or a Certificate Signing Request (CSR) in PEM format. When a CSR is provided, the API issues an x509 certificate and registers it in the ETSI TS 119-612 trust list XML. Returns the generated DID and, if a CSR was provided, the issued certificate.
          * @param {string} tlId
-         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record Create Payload.
+         * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record create payload. Includes organization details and either a did:key or a CSR for key material provisioning.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1346,7 +1346,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrCreate(tlId, tlrCreatePayload, options).then((request) => request(axios, basePath));
         },
         /**
-         * Removes a specific Trust List Record
+         * Permanently removes a specific Trust List Record from the Trust List. Only the Trust List owner can perform this operation. The associated DID Document and all related data will be deleted.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1356,7 +1356,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrDelete(tlId, tlrId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieves a specific Trust List record
+         * Returns a specific Trust List Record including organization details, DID, current status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. No authentication is required; used to display public entity detail pages.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1366,7 +1366,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrGet(tlId, tlrId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieves a list of Trust List Records.
+         * Searches for Trust List Records across all Trust Lists by organization name. No authentication is required. Used by public-facing directory or search features to find entities registered under a given organization name.
          * @param {string} orgName
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1375,7 +1375,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrSearch(orgName, options).then((request) => request(axios, basePath));
         },
         /**
-         * Gets Trust List Records that make up a single Trust Chain
+         * Returns the full chain of Trust List Records from the root trust anchor down to the specified record. Each element in the array represents one step in the chain of trust, showing which entities issued or accredited the next. Used to visualize and verify the complete trust path for a given organization.
          * @param {string} tlId Trust List Identifier
          * @param {string} tlrId Trust List Record Identifier
          * @param {*} [options] Override http request option.
@@ -1385,7 +1385,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrTrustChainGet(tlId, tlrId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieves a list of Trust List records.
+         * Returns all Trust List Records belonging to a specific Trust List. Each record represents an organization with its DID, status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. Used to display the list of entities participating in a trust ecosystem.
          * @param {string} tlId
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1394,7 +1394,7 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.tlrsGet(tlId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Gets a Verifiable Presentation.
+         * Retrieves the Verifiable Presentation (VP) stored for a specific Trust List Record. The VP is encoded as a JWT and represents the credential presented during the onboarding process, proving the entity\'s eligibility to join the Trust List. Used to audit or display the onboarding evidence for a given record.
          * @param {string} tlId
          * @param {string} did
          * @param {string} id
@@ -1412,7 +1412,7 @@ exports.DefaultApiFactory = DefaultApiFactory;
  */
 class DefaultApi extends base_1.BaseAPI {
     /**
-     * Retrieves a specific DID Document
+     * Returns the W3C DID Document for the specified Trust List Record. The document contains the entity\'s DID, cryptographic verification methods, and service endpoints. This endpoint follows the `did:web` resolution convention and is used by DID resolvers to look up the entity\'s public key material and service information.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
      * @param {*} [options] Override http request option.
@@ -1422,7 +1422,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).didGet(tlId, tlrId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Suggests a DID
+     * Returns a suggested DID for a new Trust List Record within the specified Trust List. The suggested DID is derived from the Trust List\'s DID base and can be used to pre-fill the DID field when creating a new record.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1431,10 +1431,10 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).didSuggest(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Adds DID Verification method.
+     * Adds a new verification method to the DID Document of the specified Trust List Record. The verification method includes cryptographic key material (e.g. Ed25519, RSA, or ES256K) and is registered under the assertionMethod, authentication, and capabilityInvocation relationships in the DID Document.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
-     * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method.
+     * @param {VerificationMethodCreatePayload} [verificationMethodCreatePayload] Verification method to add, including its type, controller DID, key ID, and key material.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1442,10 +1442,10 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).didVerificationMethodAdd(tlId, tlrId, verificationMethodCreatePayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Adds DID Verification method.
+     * Updates an existing verification method on the DID Document of a Trust List Record. Primarily used to revoke a verification method by setting the `revoked` timestamp, which marks the key as no longer valid and transitions the Trust List Record status to `revoked`. The Trust List Record\'s status in the ETSI trust list XML is updated accordingly.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
-     * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Verification method.
+     * @param {VerificationMethodPatchPayload} [verificationMethodPatchPayload] Partial verification method update payload. Provide the key ID and the fields to update, such as the `revoked` timestamp to revoke the key.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1453,7 +1453,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).didVerificationMethodPatch(tlId, tlrId, verificationMethodPatchPayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Returns an ETSI 119 602 Trusted list
+     * Returns the Trust List in ETSI TS 119-602 XML format, which defines the standard for trust frameworks of identity wallet ecosystems (e.g. EUDI Wallet). The XML document includes Trust List Records with their DID-based cryptographic material and accreditation information, suitable for consumption by wallet verifiers and trust framework participants.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1462,7 +1462,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).etsiTl602Get(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Returns an ETSI 119 612 Trusted list
+     * Returns the Trust List in ETSI TS 119-612 XML format, which defines the standard for Trusted Lists of Trust Service Providers (TSPs) in the context of electronic signatures and qualified trust services. The XML document includes all active, onboarded, and revoked Trust List Records with their x509 certificates and service status information, suitable for consumption by conformant trust service validators.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1471,7 +1471,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).etsiTl612Get(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     *
+     * Returns the operational health status of the Trust List API service. Useful for monitoring, load balancer checks, and readiness probes.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1479,9 +1479,9 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).healthCheck(options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Initiates the onboarding process to the DID registry.
+     * Initiates the credential-based onboarding process for an organization joining the specified Trust List. Returns a verifier URL to redirect the holder to, where they must present an onboarding Verifiable Credential (VC) proving their eligibility. After presenting the credential, the status can be polled via `GET /onboarding/{verifier_state}`. On successful verification, a Trust List Record is automatically created for the organization.
      * @param {string} tlId Trust List identifier
-     * @param {OnboardingPayload} [onboardingPayload] DID onboarding init payload.
+     * @param {OnboardingPayload} [onboardingPayload] Onboarding initiation payload specifying the verifier to use and optionally the holder\'s entity identifier (did:key).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1489,7 +1489,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).onboardingInit(tlId, onboardingPayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     *
+     * Polls the status of an ongoing onboarding process using the verifier state token returned by `POST /{tl_id}/onboarding`. Returns the current status (`in_progress`, `completed`, or `error`) along with the assigned DID once onboarding is complete. Clients should poll this endpoint periodically until a terminal status is reached.
      * @param {string} verifierState Verifier state
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1498,8 +1498,8 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).onboardingStatus(verifierState, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Creates a Trust List based on the specified payload.
-     * @param {TlPayload} [tlPayload] Trust List create payload.
+     * Creates a new Trust List owned by the authenticated user. A Trust List groups organizations (Trust List Records) of a specific role type (e.g. Wallet Provider, PID Provider). It requires a governance wallet for VC interactions and a verifier to validate onboarding credentials presented by joining organizations.
+     * @param {TlPayload} [tlPayload] Trust List create payload including name, type, description, and references to the governance wallet and verifier services.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1507,7 +1507,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlCreate(tlPayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Destroys the Trust List.
+     * Permanently deletes the specified Trust List and all its associated records. Only the Trust List owner can perform this operation.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1516,7 +1516,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlDelete(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Gets the specified Trust List
+     * Returns the full representation of a specific Trust List for the authenticated owner, including the verifier ID not exposed in the public directory endpoints.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1525,7 +1525,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlGet(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Provides a public information about a specific Trusted List
+     * Returns publicly accessible metadata for a specific Trust List. No authentication is required. Returns the same fields as the directory listing but for a single Trust List, excluding sensitive fields such as the verifier ID.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1534,7 +1534,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlGetPublicInfo(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Provides a list of public Trusted Lists
+     * Returns a publicly accessible directory of all Trust Lists. No authentication is required. An optional `search` query parameter filters results by name or description. Used by clients to display a browseable catalog of available trust ecosystems.
      * @param {string} [search]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1543,7 +1543,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlList(search, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Provides a list of Trusted Lists for an authenticated owner
+     * Returns all Trust Lists owned by the authenticated user. Unlike the public directory, this response includes the full Trust List representation with the verifier ID. Used to populate the authenticated user\'s management dashboard.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1551,9 +1551,9 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlListByOwner(options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Updates a Trust List based on the specified payload.
+     * Updates the metadata of an existing Trust List. Only the Trust List owner can perform this operation. Fields provided in the payload will overwrite current values.
      * @param {string} tlId
-     * @param {TlPayload} [tlPayload] Trust List create payload.
+     * @param {TlPayload} [tlPayload] Trust List update payload. Provide only the fields to update.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1561,9 +1561,9 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlPatch(tlId, tlPayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Directly creates a new Trusted List Record. When a Certificate Signing Request is provided, it will also issue an x509 certificate and update the ETSI TS 119 6**
+     * Directly creates a new Trust List Record in the specified Trust List, bypassing the credential-based onboarding flow. The public key material must be provided either as a `did:key` or a Certificate Signing Request (CSR) in PEM format. When a CSR is provided, the API issues an x509 certificate and registers it in the ETSI TS 119-612 trust list XML. Returns the generated DID and, if a CSR was provided, the issued certificate.
      * @param {string} tlId
-     * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record Create Payload.
+     * @param {TlrCreatePayload} [tlrCreatePayload] Trust List Record create payload. Includes organization details and either a did:key or a CSR for key material provisioning.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1571,7 +1571,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrCreate(tlId, tlrCreatePayload, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Removes a specific Trust List Record
+     * Permanently removes a specific Trust List Record from the Trust List. Only the Trust List owner can perform this operation. The associated DID Document and all related data will be deleted.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
      * @param {*} [options] Override http request option.
@@ -1581,7 +1581,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrDelete(tlId, tlrId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Retrieves a specific Trust List record
+     * Returns a specific Trust List Record including organization details, DID, current status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. No authentication is required; used to display public entity detail pages.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
      * @param {*} [options] Override http request option.
@@ -1591,7 +1591,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrGet(tlId, tlrId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Retrieves a list of Trust List Records.
+     * Searches for Trust List Records across all Trust Lists by organization name. No authentication is required. Used by public-facing directory or search features to find entities registered under a given organization name.
      * @param {string} orgName
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1600,7 +1600,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrSearch(orgName, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Gets Trust List Records that make up a single Trust Chain
+     * Returns the full chain of Trust List Records from the root trust anchor down to the specified record. Each element in the array represents one step in the chain of trust, showing which entities issued or accredited the next. Used to visualize and verify the complete trust path for a given organization.
      * @param {string} tlId Trust List Identifier
      * @param {string} tlrId Trust List Record Identifier
      * @param {*} [options] Override http request option.
@@ -1610,7 +1610,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrTrustChainGet(tlId, tlrId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Retrieves a list of Trust List records.
+     * Returns all Trust List Records belonging to a specific Trust List. Each record represents an organization with its DID, status (onboarded, trusted, revoked, or expired), accreditations, and onboarding credentials. Used to display the list of entities participating in a trust ecosystem.
      * @param {string} tlId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1619,7 +1619,7 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).tlrsGet(tlId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Gets a Verifiable Presentation.
+     * Retrieves the Verifiable Presentation (VP) stored for a specific Trust List Record. The VP is encoded as a JWT and represents the credential presented during the onboarding process, proving the entity\'s eligibility to join the Trust List. Used to audit or display the onboarding evidence for a given record.
      * @param {string} tlId
      * @param {string} did
      * @param {string} id