waldur-js-client 7.8.8-dev.10 → 7.8.8-dev.11

package/dist/sdk.gen.js

@@ -2236,6 +2236,10 @@ export const azureVirtualmachinesUnlink = (options) => {
         ...options
     });
 };
+/**
+ * List backend resource requests
+ * Returns a paginated list of requests for backend resources.
+ */
 export const backendResourceRequestsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -2253,6 +2257,7 @@ export const backendResourceRequestsList = (options) => {
     });
 };
 /**
+ * List backend resource requests
  * Get number of items in the collection matching the request parameters.
  */
 export const backendResourceRequestsCount = (options) => {
@@ -2271,6 +2276,10 @@ export const backendResourceRequestsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a backend resource request
+ * Creates a new request to fetch a list of importable resources from a backend. This is typically used by staff to trigger a site agent to report available resources.
+ */
 export const backendResourceRequestsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -2291,6 +2300,10 @@ export const backendResourceRequestsCreate = (options) => {
         }
     });
 };
+/**
+ * Retrieve a backend resource request
+ * Returns the details of a specific backend resource request.
+ */
 export const backendResourceRequestsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -2307,6 +2320,10 @@ export const backendResourceRequestsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Mark a request as done
+ * Transitions the request state from 'Processing' to 'Done'. This is used by a site agent to signal that it has successfully reported all available resources.
+ */
 export const backendResourceRequestsSetDone = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -2323,6 +2340,10 @@ export const backendResourceRequestsSetDone = (options) => {
         ...options
     });
 };
+/**
+ * Mark a request as erred
+ * Transitions the request state to 'Erred'. This is used by a site agent to report a failure during the resource fetching process. An error message and traceback should be provided.
+ */
 export const backendResourceRequestsSetErred = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -2343,6 +2364,10 @@ export const backendResourceRequestsSetErred = (options) => {
         }
     });
 };
+/**
+ * Start processing a request
+ * Transitions the request state from 'Sent' to 'Processing'. This is used by a site agent to acknowledge that it has started fetching the resource list.
+ */
 export const backendResourceRequestsStartProcessing = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -2359,6 +2384,10 @@ export const backendResourceRequestsStartProcessing = (options) => {
         ...options
     });
 };
+/**
+ * List backend resources
+ * Returns a paginated list of backend resources that are available for import. This endpoint is typically used by site agents to see which resources they have reported.
+ */
 export const backendResourcesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -2376,6 +2405,7 @@ export const backendResourcesList = (options) => {
     });
 };
 /**
+ * List backend resources
  * Get number of items in the collection matching the request parameters.
  */
 export const backendResourcesCount = (options) => {
@@ -2394,6 +2424,10 @@ export const backendResourcesCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a backend resource
+ * Creates a new backend resource record. This is typically done by a site agent to report a resource that is available for import into the marketplace.
+ */
 export const backendResourcesCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -2414,6 +2448,10 @@ export const backendResourcesCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a backend resource
+ * Deletes a backend resource record. This is typically done when the resource is no longer available for import.
+ */
 export const backendResourcesDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -2430,6 +2468,10 @@ export const backendResourcesDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a backend resource
+ * Returns the details of a specific backend resource.
+ */
 export const backendResourcesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -2446,6 +2488,14 @@ export const backendResourcesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Import a backend resource (staff only)
+ *
+ * Converts a backend resource into a full marketplace resource. This action is restricted to staff users.
+ * Upon successful import, the original backend resource record is deleted. A fake order in the 'done'
+ * state is created to represent the import event.
+ *
+ */
 export const backendResourcesImportResource = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -4094,6 +4144,10 @@ export const checklistsAdminChecklistQuestions = (options) => {
         ...options
     });
 };
+/**
+ * List component usage limits for users
+ * Returns a paginated list of usage limits set for specific users on resource components.
+ */
 export const componentUserUsageLimitsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -4111,6 +4165,7 @@ export const componentUserUsageLimitsList = (options) => {
     });
 };
 /**
+ * List component usage limits for users
  * Get number of items in the collection matching the request parameters.
  */
 export const componentUserUsageLimitsCount = (options) => {
@@ -4129,6 +4184,10 @@ export const componentUserUsageLimitsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a component usage limit for a user
+ * Sets a usage limit for a specific user on a resource's component. This is only applicable for offerings that support per-user consumption limitation.
+ */
 export const componentUserUsageLimitsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -4149,6 +4208,10 @@ export const componentUserUsageLimitsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a component usage limit
+ * Removes a usage limit for a user on a component.
+ */
 export const componentUserUsageLimitsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -4165,6 +4228,10 @@ export const componentUserUsageLimitsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a component usage limit
+ * Returns the details of a specific user's usage limit for a component.
+ */
 export const componentUserUsageLimitsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -4181,6 +4248,10 @@ export const componentUserUsageLimitsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a component usage limit
+ * Partially updates an existing usage limit for a user on a component.
+ */
 export const componentUserUsageLimitsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -4201,6 +4272,10 @@ export const componentUserUsageLimitsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a component usage limit
+ * Updates an existing usage limit for a user on a component.
+ */
 export const componentUserUsageLimitsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -7606,6 +7681,10 @@ export const lexisLinksUpdate = (options) => {
         }
     });
 };
+/**
+ * List affected offerings for maintenance
+ * Returns a paginated list of offerings affected by maintenance announcements.
+ */
 export const maintenanceAnnouncementOfferingsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -7623,6 +7702,7 @@ export const maintenanceAnnouncementOfferingsList = (options) => {
     });
 };
 /**
+ * List affected offerings for maintenance
  * Get number of items in the collection matching the request parameters.
  */
 export const maintenanceAnnouncementOfferingsCount = (options) => {
@@ -7641,6 +7721,10 @@ export const maintenanceAnnouncementOfferingsCount = (options) => {
         ...options
     });
 };
+/**
+ * Link an offering to a maintenance announcement
+ * Creates a new association between an offering and a maintenance announcement, specifying the expected impact.
+ */
 export const maintenanceAnnouncementOfferingsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -7661,6 +7745,10 @@ export const maintenanceAnnouncementOfferingsCreate = (options) => {
         }
     });
 };
+/**
+ * Unlink an offering from a maintenance announcement
+ * Removes the association between an offering and a maintenance announcement.
+ */
 export const maintenanceAnnouncementOfferingsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -7677,6 +7765,10 @@ export const maintenanceAnnouncementOfferingsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an affected offering link
+ * Returns the details of a specific link between a maintenance announcement and an offering, including the impact level and description.
+ */
 export const maintenanceAnnouncementOfferingsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -7693,6 +7785,10 @@ export const maintenanceAnnouncementOfferingsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update an affected offering link
+ * Partially updates the impact level or description for an offering linked to a maintenance announcement.
+ */
 export const maintenanceAnnouncementOfferingsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -7713,6 +7809,10 @@ export const maintenanceAnnouncementOfferingsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update an affected offering link
+ * Updates the impact level or description for an offering linked to a maintenance announcement.
+ */
 export const maintenanceAnnouncementOfferingsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -7733,6 +7833,10 @@ export const maintenanceAnnouncementOfferingsUpdate = (options) => {
         }
     });
 };
+/**
+ * List affected offering templates
+ * Returns a paginated list of associations between maintenance announcement templates and offerings.
+ */
 export const maintenanceAnnouncementTemplateOfferingsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -7750,6 +7854,7 @@ export const maintenanceAnnouncementTemplateOfferingsList = (options) => {
     });
 };
 /**
+ * List affected offering templates
  * Get number of items in the collection matching the request parameters.
  */
 export const maintenanceAnnouncementTemplateOfferingsCount = (options) => {
@@ -7768,6 +7873,10 @@ export const maintenanceAnnouncementTemplateOfferingsCount = (options) => {
         ...options
     });
 };
+/**
+ * Link an offering to a maintenance template
+ * Creates a reusable association between an offering and a maintenance announcement template, specifying a default impact level and description.
+ */
 export const maintenanceAnnouncementTemplateOfferingsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -7788,6 +7897,10 @@ export const maintenanceAnnouncementTemplateOfferingsCreate = (options) => {
         }
     });
 };
+/**
+ * Unlink an offering from a maintenance template
+ * Removes the association between an offering and a maintenance announcement template.
+ */
 export const maintenanceAnnouncementTemplateOfferingsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -7804,6 +7917,10 @@ export const maintenanceAnnouncementTemplateOfferingsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an affected offering template link
+ * Returns the details of a specific link between a maintenance announcement template and an offering.
+ */
 export const maintenanceAnnouncementTemplateOfferingsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -7820,6 +7937,10 @@ export const maintenanceAnnouncementTemplateOfferingsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update an affected offering template link
+ * Partially updates the default impact level or description for an offering linked to a maintenance template.
+ */
 export const maintenanceAnnouncementTemplateOfferingsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -7840,6 +7961,10 @@ export const maintenanceAnnouncementTemplateOfferingsPartialUpdate = (options) =
         }
     });
 };
+/**
+ * Update an affected offering template link
+ * Updates the default impact level or description for an offering linked to a maintenance template.
+ */
 export const maintenanceAnnouncementTemplateOfferingsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -7860,6 +7985,10 @@ export const maintenanceAnnouncementTemplateOfferingsUpdate = (options) => {
         }
     });
 };
+/**
+ * List maintenance announcements
+ * Returns a paginated list of maintenance announcements.
+ */
 export const maintenanceAnnouncementsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -7877,6 +8006,7 @@ export const maintenanceAnnouncementsList = (options) => {
     });
 };
 /**
+ * List maintenance announcements
  * Get number of items in the collection matching the request parameters.
  */
 export const maintenanceAnnouncementsCount = (options) => {
@@ -7895,6 +8025,10 @@ export const maintenanceAnnouncementsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a maintenance announcement
+ * Creates a new maintenance announcement in the 'Draft' state.
+ */
 export const maintenanceAnnouncementsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -7915,6 +8049,10 @@ export const maintenanceAnnouncementsCreate = (options) => {
         }
     });
 };
+/**
+ * List maintenance announcement templates
+ * Returns a paginated list of reusable templates for maintenance announcements.
+ */
 export const maintenanceAnnouncementsTemplateList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -7932,6 +8070,7 @@ export const maintenanceAnnouncementsTemplateList = (options) => {
     });
 };
 /**
+ * List maintenance announcement templates
  * Get number of items in the collection matching the request parameters.
  */
 export const maintenanceAnnouncementsTemplateCount = (options) => {
@@ -7950,6 +8089,10 @@ export const maintenanceAnnouncementsTemplateCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a maintenance announcement template
+ * Creates a new reusable template for maintenance announcements, including a default message and type.
+ */
 export const maintenanceAnnouncementsTemplateCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -7970,6 +8113,10 @@ export const maintenanceAnnouncementsTemplateCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a maintenance announcement template
+ * Deletes a maintenance announcement template.
+ */
 export const maintenanceAnnouncementsTemplateDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -7986,6 +8133,10 @@ export const maintenanceAnnouncementsTemplateDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a maintenance announcement template
+ * Returns the details of a specific maintenance announcement template.
+ */
 export const maintenanceAnnouncementsTemplateRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8002,6 +8153,10 @@ export const maintenanceAnnouncementsTemplateRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a maintenance announcement template
+ * Partially updates an existing maintenance announcement template.
+ */
 export const maintenanceAnnouncementsTemplatePartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8022,6 +8177,10 @@ export const maintenanceAnnouncementsTemplatePartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a maintenance announcement template
+ * Updates an existing maintenance announcement template.
+ */
 export const maintenanceAnnouncementsTemplateUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8042,6 +8201,10 @@ export const maintenanceAnnouncementsTemplateUpdate = (options) => {
         }
     });
 };
+/**
+ * Delete a maintenance announcement
+ * Deletes a maintenance announcement.
+ */
 export const maintenanceAnnouncementsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8058,6 +8221,10 @@ export const maintenanceAnnouncementsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a maintenance announcement
+ * Returns the details of a specific maintenance announcement.
+ */
 export const maintenanceAnnouncementsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8074,6 +8241,10 @@ export const maintenanceAnnouncementsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a maintenance announcement
+ * Partially updates an existing maintenance announcement.
+ */
 export const maintenanceAnnouncementsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8094,6 +8265,10 @@ export const maintenanceAnnouncementsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a maintenance announcement
+ * Updates an existing maintenance announcement.
+ */
 export const maintenanceAnnouncementsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8116,6 +8291,7 @@ export const maintenanceAnnouncementsUpdate = (options) => {
 };
 /**
  * Cancel the maintenance announcement
+ * Transitions a 'Draft' or 'Scheduled' maintenance announcement to 'Cancelled'.
  */
 export const maintenanceAnnouncementsCancelMaintenance = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -8135,6 +8311,7 @@ export const maintenanceAnnouncementsCancelMaintenance = (options) => {
 };
 /**
  * Complete the maintenance announcement
+ * Transitions an 'In progress' maintenance announcement to 'Completed', indicating that the maintenance work has finished.
  */
 export const maintenanceAnnouncementsCompleteMaintenance = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -8154,6 +8331,7 @@ export const maintenanceAnnouncementsCompleteMaintenance = (options) => {
 };
 /**
  * Schedule/publish the maintenance announcement
+ * Transitions a 'Draft' maintenance announcement to the 'Scheduled' state, making it publicly visible.
  */
 export const maintenanceAnnouncementsSchedule = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -8173,6 +8351,7 @@ export const maintenanceAnnouncementsSchedule = (options) => {
 };
 /**
  * Start the maintenance announcement
+ * Transitions a 'Scheduled' maintenance announcement to 'In progress', indicating that the maintenance work has begun.
  */
 export const maintenanceAnnouncementsStartMaintenance = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -8192,6 +8371,7 @@ export const maintenanceAnnouncementsStartMaintenance = (options) => {
 };
 /**
  * Unschedule/unpublish the maintenance announcement
+ * Transitions a 'Scheduled' maintenance announcement back to the 'Draft' state, hiding it from public view.
  */
 export const maintenanceAnnouncementsUnschedule = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -8296,6 +8476,10 @@ export const marketplaceBookingsList = (options) => {
         ...options
     });
 };
+/**
+ * List categories
+ * Returns a paginated list of marketplace categories.
+ */
 export const marketplaceCategoriesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8313,6 +8497,7 @@ export const marketplaceCategoriesList = (options) => {
     });
 };
 /**
+ * List categories
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoriesCount = (options) => {
@@ -8331,6 +8516,10 @@ export const marketplaceCategoriesCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a category
+ * Creates a new marketplace category. Requires staff permissions.
+ */
 export const marketplaceCategoriesCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -8351,6 +8540,10 @@ export const marketplaceCategoriesCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a category
+ * Deletes a marketplace category. Requires staff permissions.
+ */
 export const marketplaceCategoriesDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8367,6 +8560,10 @@ export const marketplaceCategoriesDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a category
+ * Returns details of a specific marketplace category.
+ */
 export const marketplaceCategoriesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8383,6 +8580,10 @@ export const marketplaceCategoriesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a category
+ * Partially updates an existing marketplace category. Requires staff permissions.
+ */
 export const marketplaceCategoriesPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8403,6 +8604,10 @@ export const marketplaceCategoriesPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a category
+ * Updates an existing marketplace category. Requires staff permissions.
+ */
 export const marketplaceCategoriesUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8423,6 +8628,10 @@ export const marketplaceCategoriesUpdate = (options) => {
         }
     });
 };
+/**
+ * List category columns
+ * Returns a paginated list of category columns used for resource table rendering.
+ */
 export const marketplaceCategoryColumnsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8440,6 +8649,7 @@ export const marketplaceCategoryColumnsList = (options) => {
     });
 };
 /**
+ * List category columns
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoryColumnsCount = (options) => {
@@ -8458,6 +8668,10 @@ export const marketplaceCategoryColumnsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a category column
+ * Creates a new category column. Requires staff permissions.
+ */
 export const marketplaceCategoryColumnsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -8478,6 +8692,10 @@ export const marketplaceCategoryColumnsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a category column
+ * Deletes a category column. Requires staff permissions.
+ */
 export const marketplaceCategoryColumnsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8494,6 +8712,10 @@ export const marketplaceCategoryColumnsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a category column
+ * Returns details of a specific category column.
+ */
 export const marketplaceCategoryColumnsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8510,6 +8732,10 @@ export const marketplaceCategoryColumnsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a category column
+ * Partially updates an existing category column. Requires staff permissions.
+ */
 export const marketplaceCategoryColumnsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8530,6 +8756,10 @@ export const marketplaceCategoryColumnsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a category column
+ * Updates an existing category column. Requires staff permissions.
+ */
 export const marketplaceCategoryColumnsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8550,6 +8780,17 @@ export const marketplaceCategoryColumnsUpdate = (options) => {
         }
     });
 };
+/**
+ * List aggregated category component usages
+ *
+ * Returns a paginated list of aggregated component usages for marketplace categories.
+ * This data is scoped to either a customer or a project and represents the total usage
+ * of a component type (e.g., total 'CPU hours' used across all resources of a certain category
+ * within a project).
+ *
+ * The list **must** be filtered by a `scope` parameter (either a customer or project URL).
+ *
+ */
 export const marketplaceCategoryComponentUsagesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8567,6 +8808,7 @@ export const marketplaceCategoryComponentUsagesList = (options) => {
     });
 };
 /**
+ * List aggregated category component usages
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoryComponentUsagesCount = (options) => {
@@ -8585,6 +8827,10 @@ export const marketplaceCategoryComponentUsagesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an aggregated category component usage record
+ * Returns the details of a single aggregated usage record for a category component, identified by its database ID.
+ */
 export const marketplaceCategoryComponentUsagesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8601,6 +8847,10 @@ export const marketplaceCategoryComponentUsagesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List category components
+ * Returns a paginated list of all components defined at the category level. These act as templates for components in offerings.
+ */
 export const marketplaceCategoryComponentsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8618,6 +8868,7 @@ export const marketplaceCategoryComponentsList = (options) => {
     });
 };
 /**
+ * List category components
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoryComponentsCount = (options) => {
@@ -8636,6 +8887,10 @@ export const marketplaceCategoryComponentsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a category component
+ * Creates a new component for a category. Requires staff permissions.
+ */
 export const marketplaceCategoryComponentsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -8656,6 +8911,10 @@ export const marketplaceCategoryComponentsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a category component
+ * Deletes a category component. Requires staff permissions.
+ */
 export const marketplaceCategoryComponentsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8672,6 +8931,10 @@ export const marketplaceCategoryComponentsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a category component
+ * Returns the details of a specific category component, identified by its ID.
+ */
 export const marketplaceCategoryComponentsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8688,6 +8951,10 @@ export const marketplaceCategoryComponentsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a category component
+ * Partially updates an existing category component. Requires staff permissions.
+ */
 export const marketplaceCategoryComponentsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8708,6 +8975,10 @@ export const marketplaceCategoryComponentsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a category component
+ * Updates an existing category component. Requires staff permissions.
+ */
 export const marketplaceCategoryComponentsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8728,6 +8999,10 @@ export const marketplaceCategoryComponentsUpdate = (options) => {
         }
     });
 };
+/**
+ * List category groups
+ * Returns a paginated list of category groups.
+ */
 export const marketplaceCategoryGroupsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8745,6 +9020,7 @@ export const marketplaceCategoryGroupsList = (options) => {
     });
 };
 /**
+ * List category groups
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoryGroupsCount = (options) => {
@@ -8763,6 +9039,10 @@ export const marketplaceCategoryGroupsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a category group
+ * Creates a new category group. Requires staff permissions.
+ */
 export const marketplaceCategoryGroupsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -8783,6 +9063,10 @@ export const marketplaceCategoryGroupsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a category group
+ * Deletes a category group. Requires staff permissions.
+ */
 export const marketplaceCategoryGroupsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8799,6 +9083,10 @@ export const marketplaceCategoryGroupsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a category group
+ * Returns details of a specific category group.
+ */
 export const marketplaceCategoryGroupsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8815,6 +9103,10 @@ export const marketplaceCategoryGroupsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a category group
+ * Partially updates an existing category group. Requires staff permissions.
+ */
 export const marketplaceCategoryGroupsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8835,6 +9127,10 @@ export const marketplaceCategoryGroupsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a category group
+ * Updates an existing category group. Requires staff permissions.
+ */
 export const marketplaceCategoryGroupsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8855,6 +9151,10 @@ export const marketplaceCategoryGroupsUpdate = (options) => {
         }
     });
 };
+/**
+ * List category help articles
+ * Returns a paginated list of all help articles associated with marketplace categories.
+ */
 export const marketplaceCategoryHelpArticlesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8872,6 +9172,7 @@ export const marketplaceCategoryHelpArticlesList = (options) => {
     });
 };
 /**
+ * List category help articles
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCategoryHelpArticlesCount = (options) => {
@@ -8890,6 +9191,10 @@ export const marketplaceCategoryHelpArticlesCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a category help article
+ * Creates a new help article and associates it with one or more categories. Requires staff permissions.
+ */
 export const marketplaceCategoryHelpArticlesCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -8910,6 +9215,10 @@ export const marketplaceCategoryHelpArticlesCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a category help article
+ * Deletes a help article. Requires staff permissions.
+ */
 export const marketplaceCategoryHelpArticlesDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -8926,6 +9235,10 @@ export const marketplaceCategoryHelpArticlesDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a category help article
+ * Returns the details of a specific help article, identified by its ID.
+ */
 export const marketplaceCategoryHelpArticlesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -8942,6 +9255,10 @@ export const marketplaceCategoryHelpArticlesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a category help article
+ * Partially updates an existing help article. Requires staff permissions.
+ */
 export const marketplaceCategoryHelpArticlesPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -8962,6 +9279,10 @@ export const marketplaceCategoryHelpArticlesPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a category help article
+ * Updates an existing help article. Requires staff permissions.
+ */
 export const marketplaceCategoryHelpArticlesUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -8982,6 +9303,10 @@ export const marketplaceCategoryHelpArticlesUpdate = (options) => {
         }
     });
 };
+/**
+ * List component usage records
+ * Returns a paginated list of component usage records for resources. This data is used for billing and usage tracking.
+ */
 export const marketplaceComponentUsagesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -8999,6 +9324,7 @@ export const marketplaceComponentUsagesList = (options) => {
     });
 };
 /**
+ * List component usage records
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceComponentUsagesCount = (options) => {
@@ -9017,6 +9343,10 @@ export const marketplaceComponentUsagesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a component usage record
+ * Returns the details of a specific component usage record.
+ */
 export const marketplaceComponentUsagesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -9033,6 +9363,16 @@ export const marketplaceComponentUsagesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Set user-specific component usage
+ *
+ * Allows a service provider to report usage for a specific user associated with a resource's component.
+ * This is used for detailed, per-user usage tracking within a single resource.
+ *
+ * - If a user-specific usage record already exists for the given component usage, it will be updated.
+ * - Otherwise, a new record is created.
+ *
+ */
 export const marketplaceComponentUsagesSetUserUsage = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9053,6 +9393,17 @@ export const marketplaceComponentUsagesSetUserUsage = (options) => {
         }
     });
 };
+/**
+ * Set component usage for a resource
+ *
+ * Allows a service provider to report usage for one or more components of a specific resource.
+ * This endpoint is typically used by backend systems or agents to submit periodic usage data.
+ *
+ * - If a `plan_period` is provided, the usage is associated with that period.
+ * - If only a `resource` is provided, the system will determine the correct plan period based on the current date.
+ * - If a usage record for the same resource, component, and billing period already exists, it will be updated. Otherwise, a new record is created.
+ *
+ */
 export const marketplaceComponentUsagesSetUsage = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9073,6 +9424,14 @@ export const marketplaceComponentUsagesSetUsage = (options) => {
         }
     });
 };
+/**
+ * List user-specific component usages
+ *
+ * Returns a paginated list of component usage records attributed to specific users.
+ * This provides a granular view of resource consumption, breaking down the total usage of a component
+ * by individual users.
+ *
+ */
 export const marketplaceComponentUserUsagesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -9090,6 +9449,7 @@ export const marketplaceComponentUserUsagesList = (options) => {
     });
 };
 /**
+ * List user-specific component usages
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceComponentUserUsagesCount = (options) => {
@@ -9108,6 +9468,10 @@ export const marketplaceComponentUserUsagesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a user-specific component usage record
+ * Returns the details of a single user-specific component usage record.
+ */
 export const marketplaceComponentUserUsagesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -9124,6 +9488,10 @@ export const marketplaceComponentUserUsagesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List course accounts
+ * Returns a paginated list of course accounts accessible to the current user.
+ */
 export const marketplaceCourseAccountsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -9141,6 +9509,7 @@ export const marketplaceCourseAccountsList = (options) => {
     });
 };
 /**
+ * List course accounts
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCourseAccountsCount = (options) => {
@@ -9159,6 +9528,10 @@ export const marketplaceCourseAccountsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a course account
+ * Creates a new temporary course account within a specified course project.
+ */
 export const marketplaceCourseAccountsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9179,6 +9552,10 @@ export const marketplaceCourseAccountsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete (close) a course account
+ * Deletes a course account, which triggers a 'close' operation in the backend.
+ */
 export const marketplaceCourseAccountsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -9195,6 +9572,10 @@ export const marketplaceCourseAccountsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a course account
+ * Returns the details of a specific course account.
+ */
 export const marketplaceCourseAccountsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -9211,6 +9592,10 @@ export const marketplaceCourseAccountsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Bulk create course accounts
+ * Creates multiple course accounts within a specified course project in a single request.
+ */
 export const marketplaceCourseAccountsCreateBulk = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9555,6 +9940,9 @@ export const marketplaceCustomerEstimatedCostPoliciesActionsCount = (options) =>
         ...options
     });
 };
+/**
+ * List service accounts
+ */
 export const marketplaceCustomerServiceAccountsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -9572,6 +9960,7 @@ export const marketplaceCustomerServiceAccountsList = (options) => {
     });
 };
 /**
+ * List service accounts
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceCustomerServiceAccountsCount = (options) => {
@@ -9590,6 +9979,10 @@ export const marketplaceCustomerServiceAccountsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a customer service account
+ * Creates a new service account scoped to a specific customer (organization). This generates an API key that can be used for automated access to resources across all projects within that customer.
+ */
 export const marketplaceCustomerServiceAccountsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9610,6 +10003,10 @@ export const marketplaceCustomerServiceAccountsCreate = (options) => {
         }
     });
 };
+/**
+ * Close a customer service account
+ * Deactivates a customer service account and revokes its API key.
+ */
 export const marketplaceCustomerServiceAccountsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -9626,6 +10023,9 @@ export const marketplaceCustomerServiceAccountsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a service account
+ */
 export const marketplaceCustomerServiceAccountsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -9642,6 +10042,9 @@ export const marketplaceCustomerServiceAccountsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a service account
+ */
 export const marketplaceCustomerServiceAccountsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -9662,6 +10065,9 @@ export const marketplaceCustomerServiceAccountsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a service account
+ */
 export const marketplaceCustomerServiceAccountsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -9682,6 +10088,10 @@ export const marketplaceCustomerServiceAccountsUpdate = (options) => {
         }
     });
 };
+/**
+ * Rotate API key for a customer service account
+ * Generates a new API key for the service account, immediately invalidating the old one. The new key is returned in the response.
+ */
 export const marketplaceCustomerServiceAccountsRotateApiKey = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -9699,7 +10109,14 @@ export const marketplaceCustomerServiceAccountsRotateApiKey = (options) => {
     });
 };
 /**
- * Count of resource categories for all resources accessible by user.
+ * Get resource counts by category
+ *
+ * Returns a dictionary mapping marketplace category UUIDs to the count of active (non-terminated)
+ * resources the current user has access to within that category. This is primarily used for UI
+ * dashboards or sidebars to display the number of resources in each category filter.
+ *
+ * The counts can be further filtered by providing a `project_uuid` or `customer_uuid`.
+ *
  */
 export const marketplaceGlobalCategoriesRetrieve = (options) => {
     return (options?.client ?? _heyApiClient).get({
@@ -9717,6 +10134,10 @@ export const marketplaceGlobalCategoriesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List integration statuses
+ * Returns a paginated list of integration statuses for offerings. This is used to monitor the connectivity and health of backend agents (e.g., site agents) associated with offerings.
+ */
 export const marketplaceIntegrationStatusesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -9734,6 +10155,7 @@ export const marketplaceIntegrationStatusesList = (options) => {
     });
 };
 /**
+ * List integration statuses
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceIntegrationStatusesCount = (options) => {
@@ -9752,6 +10174,10 @@ export const marketplaceIntegrationStatusesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an integration status
+ * Returns the details of a specific integration status, including the agent type, status, and last request timestamp.
+ */
 export const marketplaceIntegrationStatusesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -10122,6 +10548,10 @@ export const marketplaceOfferingPermissionsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List Datacite referrals for offerings
+ * Returns a paginated list of Datacite referrals associated with marketplace offerings. Referrals represent relationships between an offering (identified by a DOI) and other research outputs, such as publications or datasets. The list must be filtered by the offering's scope.
+ */
 export const marketplaceOfferingReferralsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -10139,6 +10569,7 @@ export const marketplaceOfferingReferralsList = (options) => {
     });
 };
 /**
+ * List Datacite referrals for offerings
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceOfferingReferralsCount = (options) => {
@@ -10157,6 +10588,10 @@ export const marketplaceOfferingReferralsCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a specific Datacite referral
+ * Returns the details of a single Datacite referral record, identified by its UUID. Details include the related identifier (PID), the type of relationship, and metadata about the related work.
+ */
 export const marketplaceOfferingReferralsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -10173,6 +10608,10 @@ export const marketplaceOfferingReferralsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List Terms of Service configurations
+ * Returns a paginated list of Terms of Service configurations for offerings. Visibility depends on user permissions: staff/support see all; service providers see their own; regular users see ToS for offerings they have consented to or shared offerings.
+ */
 export const marketplaceOfferingTermsOfServiceList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -10190,6 +10629,7 @@ export const marketplaceOfferingTermsOfServiceList = (options) => {
     });
 };
 /**
+ * List Terms of Service configurations
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceOfferingTermsOfServiceCount = (options) => {
@@ -10208,6 +10648,10 @@ export const marketplaceOfferingTermsOfServiceCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a Terms of Service configuration
+ * Creates a new Terms of Service configuration for an offering. Only one active ToS configuration is allowed per offering.
+ */
 export const marketplaceOfferingTermsOfServiceCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10228,6 +10672,10 @@ export const marketplaceOfferingTermsOfServiceCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a Terms of Service configuration
+ * Deletes a Terms of Service configuration. This is a hard delete and should be used with caution.
+ */
 export const marketplaceOfferingTermsOfServiceDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -10244,6 +10692,10 @@ export const marketplaceOfferingTermsOfServiceDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a Terms of Service configuration
+ * Returns the details of a specific Terms of Service configuration.
+ */
 export const marketplaceOfferingTermsOfServiceRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -10260,6 +10712,10 @@ export const marketplaceOfferingTermsOfServiceRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a Terms of Service configuration
+ * Partially updates an existing Terms of Service configuration.
+ */
 export const marketplaceOfferingTermsOfServicePartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -10280,6 +10736,10 @@ export const marketplaceOfferingTermsOfServicePartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a Terms of Service configuration
+ * Updates an existing Terms of Service configuration. Note that some fields like `version` and `requires_reconsent` are protected and cannot be changed after creation.
+ */
 export const marketplaceOfferingTermsOfServiceUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -10463,7 +10923,12 @@ export const marketplaceOfferingUsagePoliciesActionsCount = (options) => {
     });
 };
 /**
- * Override list to add OfferingUser data optimization.
+ * List checklist completions for offering users
+ *
+ * Returns a paginated list of all checklist completions for offering users that the current user is allowed to see.
+ * This endpoint is used by service providers to monitor compliance status and by users to see their own required checklists.
+ * Visibility follows the same rules as the `OfferingUsers` endpoint.
+ *
  */
 export const marketplaceOfferingUserChecklistCompletionsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
@@ -10482,6 +10947,7 @@ export const marketplaceOfferingUserChecklistCompletionsList = (options) => {
     });
 };
 /**
+ * List checklist completions for offering users
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceOfferingUserChecklistCompletionsCount = (options) => {
@@ -10500,6 +10966,10 @@ export const marketplaceOfferingUserChecklistCompletionsCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a checklist completion
+ * Returns the details of a specific checklist completion for an offering user.
+ */
 export const marketplaceOfferingUserChecklistCompletionsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -10643,6 +11113,10 @@ export const marketplaceOfferingUserRolesUpdate = (options) => {
         }
     });
 };
+/**
+ * List offering users
+ * Returns a paginated list of users associated with offerings. The visibility of users depends on the role of the authenticated user. Staff and support can see all users. Service providers can see users of their offerings if the user has consented. Regular users can only see their own offering-user records.
+ */
 export const marketplaceOfferingUsersList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -10660,6 +11134,7 @@ export const marketplaceOfferingUsersList = (options) => {
     });
 };
 /**
+ * List offering users
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceOfferingUsersCount = (options) => {
@@ -10678,6 +11153,10 @@ export const marketplaceOfferingUsersCount = (options) => {
         ...options
     });
 };
+/**
+ * Create an offering user
+ * Associates a user with a specific offering, creating an offering-specific user account. This is typically done by a service provider.
+ */
 export const marketplaceOfferingUsersCreate = (options) => {
     return (options?.client ?? _heyApiClient).post({
         security: [
@@ -10698,6 +11177,10 @@ export const marketplaceOfferingUsersCreate = (options) => {
         }
     });
 };
+/**
+ * Delete an offering user
+ * Removes the association between a user and an offering. This action may trigger backend cleanup processes depending on the offering type.
+ */
 export const marketplaceOfferingUsersDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -10714,6 +11197,10 @@ export const marketplaceOfferingUsersDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an offering user
+ * Returns the details of a specific offering-user link. Visibility follows the same rules as the list view.
+ */
 export const marketplaceOfferingUsersRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -10770,6 +11257,10 @@ export const marketplaceOfferingUsersUpdate = (options) => {
         }
     });
 };
+/**
+ * Begin creation process
+ * Transitions the offering user state from 'Requested' or 'Error Creating' to 'Creating'. This is typically used by an agent to signal that the creation process has started.
+ */
 export const marketplaceOfferingUsersBeginCreating = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10863,7 +11354,8 @@ export const marketplaceOfferingUsersCompletionStatusRetrieve = (options) => {
     });
 };
 /**
- * Action to request deletion of an offering user account.
+ * Request deletion of an offering user
+ * Initiates the deletion process for an offering user account by transitioning it to the 'Deletion Requested' state.
  */
 export const marketplaceOfferingUsersRequestDeletion = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -10882,7 +11374,8 @@ export const marketplaceOfferingUsersRequestDeletion = (options) => {
     });
 };
 /**
- * Action to mark an offering user as successfully deleted.
+ * Set state to Deleted
+ * Transitions the offering user to the 'Deleted' state, marking the successful completion of the deletion process.
  */
 export const marketplaceOfferingUsersSetDeleted = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -10901,7 +11394,8 @@ export const marketplaceOfferingUsersSetDeleted = (options) => {
     });
 };
 /**
- * Action to begin the deletion process for an offering user.
+ * Begin deletion process
+ * Transitions the offering user to the 'Deleting' state. This is typically used by an agent to signal that the deletion process has started.
  */
 export const marketplaceOfferingUsersSetDeleting = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -10919,6 +11413,10 @@ export const marketplaceOfferingUsersSetDeleting = (options) => {
         ...options
     });
 };
+/**
+ * Set state to Error Creating
+ * Manually moves the offering user into the 'Error Creating' state. This is typically used by an agent to report a failure during the creation process.
+ */
 export const marketplaceOfferingUsersSetErrorCreating = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10935,6 +11433,10 @@ export const marketplaceOfferingUsersSetErrorCreating = (options) => {
         ...options
     });
 };
+/**
+ * Set state to Error Deleting
+ * Manually moves the offering user into the 'Error Deleting' state. This is typically used by an agent to report a failure during the deletion process.
+ */
 export const marketplaceOfferingUsersSetErrorDeleting = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10951,6 +11453,10 @@ export const marketplaceOfferingUsersSetErrorDeleting = (options) => {
         ...options
     });
 };
+/**
+ * Set state to OK
+ * Manually sets the offering user state to 'OK'. This can be used to recover from an error state or to complete a manual creation process.
+ */
 export const marketplaceOfferingUsersSetOk = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10967,6 +11473,10 @@ export const marketplaceOfferingUsersSetOk = (options) => {
         ...options
     });
 };
+/**
+ * Set state to Pending Account Linking
+ * Transitions the state to 'Pending Account Linking' and allows a service provider to add a comment and a URL to guide the user.
+ */
 export const marketplaceOfferingUsersSetPendingAccountLinking = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -10987,6 +11497,10 @@ export const marketplaceOfferingUsersSetPendingAccountLinking = (options) => {
         }
     });
 };
+/**
+ * Set state to Pending Additional Validation
+ * Transitions the state to 'Pending Additional Validation' and allows a service provider to add a comment and a URL for the user to follow.
+ */
 export const marketplaceOfferingUsersSetPendingAdditionalValidation = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11007,6 +11521,10 @@ export const marketplaceOfferingUsersSetPendingAdditionalValidation = (options)
         }
     });
 };
+/**
+ * Set state to Validation Complete
+ * Transitions the state from a pending validation state to 'OK', indicating that the user has completed the required steps. This clears any service provider comments.
+ */
 export const marketplaceOfferingUsersSetValidationComplete = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11047,7 +11565,8 @@ export const marketplaceOfferingUsersSubmitAnswers = (options) => {
     });
 };
 /**
- * Action for service providers to update comment and comment URL fields.
+ * Update service provider comments
+ * Allows a service provider to update the `service_provider_comment` and `service_provider_comment_url` fields for an offering user. This is often used to provide feedback or instructions during a pending state.
  */
 export const marketplaceOfferingUsersUpdateCommentsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
@@ -11069,6 +11588,10 @@ export const marketplaceOfferingUsersUpdateCommentsPartialUpdate = (options) =>
         }
     });
 };
+/**
+ * Update restriction status
+ * Allows a service provider to mark an offering user as restricted or unrestricted. A restricted user may have limited access to the resource.
+ */
 export const marketplaceOfferingUsersUpdateRestricted = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11127,6 +11650,10 @@ export const marketplaceOfferingUsersChecklistTemplateCount = (options) => {
         ...options
     });
 };
+/**
+ * List orders
+ * Returns a paginated list of orders accessible to the current user. Orders are visible to service consumers (project/customer members with appropriate permissions) and service providers.
+ */
 export const marketplaceOrdersList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -11144,6 +11671,7 @@ export const marketplaceOrdersList = (options) => {
     });
 };
 /**
+ * List orders
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceOrdersCount = (options) => {
@@ -11162,6 +11690,10 @@ export const marketplaceOrdersCount = (options) => {
         ...options
     });
 };
+/**
+ * Create an order
+ * Creates a new order to provision a resource. The order will be placed in a pending state and may require approval depending on the offering and user permissions.
+ */
 export const marketplaceOrdersCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11182,6 +11714,10 @@ export const marketplaceOrdersCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a pending order
+ * Deletes an order that is still in a pending state (e.g., `pending-consumer` or `pending-provider`). Executing or completed orders cannot be deleted.
+ */
 export const marketplaceOrdersDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -11198,6 +11734,10 @@ export const marketplaceOrdersDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve an order
+ * Returns the details of a specific order.
+ */
 export const marketplaceOrdersRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -11214,6 +11754,10 @@ export const marketplaceOrdersRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Approve an order (consumer)
+ * Approves a pending order from the consumer's side (e.g., project manager, customer owner). This transitions the order to the next state, which could be pending provider approval or executing.
+ */
 export const marketplaceOrdersApproveByConsumer = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11230,6 +11774,10 @@ export const marketplaceOrdersApproveByConsumer = (options) => {
         ...options
     });
 };
+/**
+ * Approve an order (provider)
+ * Approves a pending order from the provider's side. This typically transitions the order to the executing state.
+ */
 export const marketplaceOrdersApproveByProvider = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11246,6 +11794,10 @@ export const marketplaceOrdersApproveByProvider = (options) => {
         ...options
     });
 };
+/**
+ * Cancel an order
+ * Cancels an order. This is typically only possible for certain offering types (e.g., basic support) and in specific states (pending or executing).
+ */
 export const marketplaceOrdersCancel = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11263,7 +11815,8 @@ export const marketplaceOrdersCancel = (options) => {
     });
 };
 /**
- * Delete the attachment from a pending order.
+ * Delete order attachment
+ * Allows deleting an attachment from a pending order.
  */
 export const marketplaceOrdersDeleteAttachment = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -11281,6 +11834,10 @@ export const marketplaceOrdersDeleteAttachment = (options) => {
         ...options
     });
 };
+/**
+ * Get offering details
+ * Returns details of the offering connected to the requested object.
+ */
 export const marketplaceOrdersOfferingRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -11297,6 +11854,10 @@ export const marketplaceOrdersOfferingRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Reject an order (consumer)
+ * Rejects a pending order from the consumer's side. This moves the order to the 'rejected' state.
+ */
 export const marketplaceOrdersRejectByConsumer = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11313,6 +11874,10 @@ export const marketplaceOrdersRejectByConsumer = (options) => {
         ...options
     });
 };
+/**
+ * Reject an order (provider)
+ * Rejects a pending order from the provider's side. This moves the order to the 'rejected' state.
+ */
 export const marketplaceOrdersRejectByProvider = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11329,6 +11894,10 @@ export const marketplaceOrdersRejectByProvider = (options) => {
         ...options
     });
 };
+/**
+ * Set order backend ID
+ * Allows a service provider or staff to set or update the backend ID associated with an order. This is useful for linking the order to an external system's identifier.
+ */
 export const marketplaceOrdersSetBackendId = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11349,6 +11918,10 @@ export const marketplaceOrdersSetBackendId = (options) => {
         }
     });
 };
+/**
+ * Set order state to done (agent)
+ * Used by external agents (e.g., site agent) to manually transition the order state to 'done'. This is only applicable for specific offering types.
+ */
 export const marketplaceOrdersSetStateDone = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11365,6 +11938,10 @@ export const marketplaceOrdersSetStateDone = (options) => {
         ...options
     });
 };
+/**
+ * Set order state to erred (agent)
+ * Used by external agents to report a failure during order processing. An error message and traceback can be provided.
+ */
 export const marketplaceOrdersSetStateErred = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11385,6 +11962,10 @@ export const marketplaceOrdersSetStateErred = (options) => {
         }
     });
 };
+/**
+ * Set order state to executing (agent)
+ * Used by external agents (e.g., site agent) to manually transition the order state to 'executing'. This is only applicable for specific offering types.
+ */
 export const marketplaceOrdersSetStateExecuting = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11401,6 +11982,10 @@ export const marketplaceOrdersSetStateExecuting = (options) => {
         ...options
     });
 };
+/**
+ * Unlink an order (staff only)
+ * Forcefully deletes an order from the database without affecting the backend resource. This is a staff-only administrative action used to clean up stuck or invalid orders.
+ */
 export const marketplaceOrdersUnlink = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11418,7 +12003,8 @@ export const marketplaceOrdersUnlink = (options) => {
     });
 };
 /**
- * Update the attachment for a pending order.
+ * Update order attachment
+ * Allows uploading or replacing a file attachment (e.g., a purchase order) for a pending order.
  */
 export const marketplaceOrdersUpdateAttachment = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -11440,6 +12026,10 @@ export const marketplaceOrdersUpdateAttachment = (options) => {
         }
     });
 };
+/**
+ * List plan components
+ * Returns a paginated list of all plan components. A plan component defines the pricing and quotas for an offering component within a billing plan. The list is filtered based on the current user's access permissions and organization group memberships.
+ */
 export const marketplacePlanComponentsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -11457,6 +12047,7 @@ export const marketplacePlanComponentsList = (options) => {
     });
 };
 /**
+ * List plan components
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplacePlanComponentsCount = (options) => {
@@ -11475,6 +12066,10 @@ export const marketplacePlanComponentsCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a plan component
+ * Returns the details of a specific plan component, including its pricing, quotas, and associated offering and plan information.
+ */
 export const marketplacePlanComponentsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -11491,6 +12086,10 @@ export const marketplacePlanComponentsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List provider plans
+ * Returns a paginated list of plans managed by the provider. The list is filtered based on the current user's access to the offering's customer.
+ */
 export const marketplacePlansList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -11508,6 +12107,7 @@ export const marketplacePlansList = (options) => {
     });
 };
 /**
+ * List provider plans
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplacePlansCount = (options) => {
@@ -11526,6 +12126,10 @@ export const marketplacePlansCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a provider plan
+ * Creates a new billing plan for an offering.
+ */
 export const marketplacePlansCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11546,6 +12150,10 @@ export const marketplacePlansCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a provider plan
+ * Deletes a plan. This is a hard delete and should be used with caution.
+ */
 export const marketplacePlansDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -11562,6 +12170,10 @@ export const marketplacePlansDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a provider plan
+ * Returns details of a specific plan.
+ */
 export const marketplacePlansRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -11578,6 +12190,10 @@ export const marketplacePlansRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a provider plan
+ * Partially updates an existing plan. Note: A plan cannot be updated if it is already used by resources.
+ */
 export const marketplacePlansPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -11598,6 +12214,10 @@ export const marketplacePlansPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a provider plan
+ * Updates an existing plan. Note: A plan cannot be updated if it is already used by resources.
+ */
 export const marketplacePlansUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -11618,6 +12238,10 @@ export const marketplacePlansUpdate = (options) => {
         }
     });
 };
+/**
+ * Archive a plan
+ * Marks a plan as archived. Archived plans cannot be used for provisioning new resources, but existing resources will continue to be billed according to this plan.
+ */
 export const marketplacePlansArchive = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11634,6 +12258,10 @@ export const marketplacePlansArchive = (options) => {
         ...options
     });
 };
+/**
+ * Remove all organization groups from a plan
+ * Removes all organization group associations from this plan, making it accessible to all users (subject to offering-level restrictions).
+ */
 export const marketplacePlansDeleteOrganizationGroups = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11651,6 +12279,8 @@ export const marketplacePlansDeleteOrganizationGroups = (options) => {
     });
 };
 /**
+ * Update plan component discounts
+ *
  * Update volume discount configuration for plan components.
  *
  * This endpoint allows updating discount thresholds and rates for multiple
@@ -11658,8 +12288,9 @@ export const marketplacePlansDeleteOrganizationGroups = (options) => {
  * when limit quantities meet or exceed the threshold.
  *
  * The discount configuration affects future billing:
- * - Creates separate invoice items showing the discount
- * - Can be enabled or disabled per component
+ * - Creates separate invoice items showing the discount.
+ * - Can be enabled or disabled per component.
+ *
  */
 export const marketplacePlansUpdateDiscounts = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -11681,6 +12312,10 @@ export const marketplacePlansUpdateDiscounts = (options) => {
         }
     });
 };
+/**
+ * Update organization groups for a plan
+ * Sets the list of organization groups that are allowed to access this plan. If the list is empty, the plan is accessible to all.
+ */
 export const marketplacePlansUpdateOrganizationGroups = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11701,6 +12336,10 @@ export const marketplacePlansUpdateOrganizationGroups = (options) => {
         }
     });
 };
+/**
+ * Update plan component prices
+ * Updates the prices for one or more components of a specific plan. If the plan is already in use by resources, this action updates the `future_price`, which will be applied from the next billing period. Otherwise, the current `price` is updated directly.
+ */
 export const marketplacePlansUpdatePrices = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11721,6 +12360,10 @@ export const marketplacePlansUpdatePrices = (options) => {
         }
     });
 };
+/**
+ * Update plan component quotas
+ * Updates the quotas (fixed amounts) for one or more components of a specific plan. This is only applicable for components with a 'fixed-price' billing type.
+ */
 export const marketplacePlansUpdateQuotas = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11741,6 +12384,10 @@ export const marketplacePlansUpdateQuotas = (options) => {
         }
     });
 };
+/**
+ * Get plan usage statistics
+ * Returns aggregated statistics on how many resources are currently using each plan. Can be filtered by offering or service provider.
+ */
 export const marketplacePlansUsageStatsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -11758,6 +12405,7 @@ export const marketplacePlansUsageStatsList = (options) => {
     });
 };
 /**
+ * Get plan usage statistics
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplacePlansUsageStatsCount = (options) => {
@@ -11776,6 +12424,18 @@ export const marketplacePlansUsageStatsCount = (options) => {
         ...options
     });
 };
+/**
+ * List available marketplace plugins and their components
+ *
+ * Returns a list of all registered marketplace plugins (offering types) and the components
+ * associated with each. This endpoint is public and does not require authentication.
+ *
+ * Each plugin entry includes:
+ * - `offering_type`: A unique identifier for the plugin.
+ * - `components`: A list of components provided by the plugin, each with its `type`, `name`, `measured_unit`, and `billing_type`.
+ * - `available_limits`: A list of component types that support user-defined limits for this plugin.
+ *
+ */
 export const marketplacePluginsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         url: '/api/marketplace-plugins/',
@@ -11944,6 +12604,9 @@ export const marketplaceProjectEstimatedCostPoliciesActionsCount = (options) =>
         ...options
     });
 };
+/**
+ * List service accounts
+ */
 export const marketplaceProjectServiceAccountsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -11961,6 +12624,7 @@ export const marketplaceProjectServiceAccountsList = (options) => {
     });
 };
 /**
+ * List service accounts
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceProjectServiceAccountsCount = (options) => {
@@ -11979,6 +12643,10 @@ export const marketplaceProjectServiceAccountsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a project service account
+ * Creates a new service account scoped to a specific project. This generates an API key that can be used for automated access to resources within that project.
+ */
 export const marketplaceProjectServiceAccountsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -11999,6 +12667,10 @@ export const marketplaceProjectServiceAccountsCreate = (options) => {
         }
     });
 };
+/**
+ * Close a project service account
+ * Deactivates a project service account and revokes its API key.
+ */
 export const marketplaceProjectServiceAccountsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -12015,6 +12687,9 @@ export const marketplaceProjectServiceAccountsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a service account
+ */
 export const marketplaceProjectServiceAccountsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12031,6 +12706,9 @@ export const marketplaceProjectServiceAccountsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a service account
+ */
 export const marketplaceProjectServiceAccountsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -12051,6 +12729,9 @@ export const marketplaceProjectServiceAccountsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a service account
+ */
 export const marketplaceProjectServiceAccountsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -12071,6 +12752,10 @@ export const marketplaceProjectServiceAccountsUpdate = (options) => {
         }
     });
 };
+/**
+ * Rotate API key for a project service account
+ * Generates a new API key for the service account, immediately invalidating the old one. The new key is returned in the response.
+ */
 export const marketplaceProjectServiceAccountsRotateApiKey = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12184,6 +12869,10 @@ export const marketplaceProjectUpdateRequestsReject = (options) => {
         }
     });
 };
+/**
+ * List provider offerings
+ * Returns a paginated list of offerings for the provider.
+ */
 export const marketplaceProviderOfferingsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -12201,6 +12890,7 @@ export const marketplaceProviderOfferingsList = (options) => {
     });
 };
 /**
+ * List provider offerings
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceProviderOfferingsCount = (options) => {
@@ -12219,6 +12909,10 @@ export const marketplaceProviderOfferingsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a provider offering
+ * Creates a new provider offering.
+ */
 export const marketplaceProviderOfferingsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12239,6 +12933,10 @@ export const marketplaceProviderOfferingsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a provider offering
+ * Deletes a provider offering. Only possible for offerings in a Draft state with no associated resources.
+ */
 export const marketplaceProviderOfferingsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -12255,6 +12953,10 @@ export const marketplaceProviderOfferingsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a provider offering
+ * Returns details of a specific provider offering.
+ */
 export const marketplaceProviderOfferingsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12271,6 +12973,10 @@ export const marketplaceProviderOfferingsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Activate an offering
+ * Activates a draft or paused offering, making it available for ordering.
+ */
 export const marketplaceProviderOfferingsActivate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12288,7 +12994,8 @@ export const marketplaceProviderOfferingsActivate = (options) => {
     });
 };
 /**
- * Add endpoint to offering.
+ * Add an access endpoint to an offering
+ * Adds a new access endpoint (URL) to an offering.
  */
 export const marketplaceProviderOfferingsAddEndpoint = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12311,7 +13018,8 @@ export const marketplaceProviderOfferingsAddEndpoint = (options) => {
     });
 };
 /**
- * Add SLURM partition configuration to offering.
+ * Add a partition to an offering
+ * Adds a new partition configuration to an offering.
  */
 export const marketplaceProviderOfferingsAddPartition = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12334,7 +13042,8 @@ export const marketplaceProviderOfferingsAddPartition = (options) => {
     });
 };
 /**
- * Add software catalog to offering.
+ * Add a software catalog to an offering
+ * Associates a software catalog with an offering and configures enabled CPU architectures.
  */
 export const marketplaceProviderOfferingsAddSoftwareCatalog = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12380,6 +13089,10 @@ export const marketplaceProviderOfferingsAddUser = (options) => {
         }
     });
 };
+/**
+ * Archive an offering
+ * Archives an offering, making it permanently unavailable for new orders.
+ */
 export const marketplaceProviderOfferingsArchive = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12397,7 +13110,8 @@ export const marketplaceProviderOfferingsArchive = (options) => {
     });
 };
 /**
- * Get statistics for offering components.
+ * Get statistics for offering components
+ * Returns monthly usage statistics for the components of an offering within a specified date range.
  */
 export const marketplaceProviderOfferingsComponentStatsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12416,7 +13130,8 @@ export const marketplaceProviderOfferingsComponentStatsList = (options) => {
     });
 };
 /**
- * Get costs for offering.
+ * Get costs for an offering
+ * Returns monthly cost data for an offering within a specified date range.
  */
 export const marketplaceProviderOfferingsCostsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12434,6 +13149,10 @@ export const marketplaceProviderOfferingsCostsList = (options) => {
         ...options
     });
 };
+/**
+ * Create an offering component
+ * Adds a new custom component to an offering.
+ */
 export const marketplaceProviderOfferingsCreateOfferingComponent = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12455,7 +13174,8 @@ export const marketplaceProviderOfferingsCreateOfferingComponent = (options) =>
     });
 };
 /**
- * Get customers for offering.
+ * Get customers for an offering
+ * Returns a paginated list of customers who have resources for this offering.
  */
 export const marketplaceProviderOfferingsCustomersList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12474,7 +13194,8 @@ export const marketplaceProviderOfferingsCustomersList = (options) => {
     });
 };
 /**
- * Delete endpoint from offering.
+ * Delete an access endpoint from an offering
+ * Deletes an existing access endpoint from an offering by its UUID.
  */
 export const marketplaceProviderOfferingsDeleteEndpoint = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12497,7 +13218,8 @@ export const marketplaceProviderOfferingsDeleteEndpoint = (options) => {
     });
 };
 /**
- * Delete offering image.
+ * Delete offering image
+ * Deletes the main image of an offering.
  */
 export const marketplaceProviderOfferingsDeleteImage = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12516,7 +13238,8 @@ export const marketplaceProviderOfferingsDeleteImage = (options) => {
     });
 };
 /**
- * Delete organization groups for offering.
+ * Delete organization groups for offering
+ * Removes all organization group associations from this offering, making it accessible to all.
  */
 export const marketplaceProviderOfferingsDeleteOrganizationGroups = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12535,7 +13258,8 @@ export const marketplaceProviderOfferingsDeleteOrganizationGroups = (options) =>
     });
 };
 /**
- * Delete offering thumbnail.
+ * Delete offering thumbnail
+ * Deletes the thumbnail image of an offering.
  */
 export const marketplaceProviderOfferingsDeleteThumbnail = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12577,6 +13301,10 @@ export const marketplaceProviderOfferingsDeleteUser = (options) => {
         }
     });
 };
+/**
+ * Move an offering to draft
+ * Moves an active or paused offering back to the draft state for editing.
+ */
 export const marketplaceProviderOfferingsDraft = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12594,10 +13322,24 @@ export const marketplaceProviderOfferingsDraft = (options) => {
     });
 };
 /**
- * This endpoint provides a config file for GLauth
- * Example: https://github.com/glauth/glauth/blob/master/v2/sample-simple.cfg
- * It is assumed that the config is used by an external agent,
- * which synchronizes data from Waldur to GLauth
+ * Get GLauth user configuration
+ *
+ * This endpoint provides a configuration file for GLauth.
+ * It is intended to be used by an external agent to synchronize user data from Waldur to GLauth.
+ *
+ * Example output format:
+ * ```
+ * [[users]]
+ * name = "johndoe"
+ * givenname="John"
+ * sn="Doe"
+ * mail = "john.doe@example.com"
+ * ...
+ * [[groups]]
+ * name = "group1"
+ * gidnumber = 1001
+ * ```
+ *
  */
 export const marketplaceProviderOfferingsGlauthUsersConfigRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12615,6 +13357,10 @@ export const marketplaceProviderOfferingsGlauthUsersConfigRetrieve = (options) =
         ...options
     });
 };
+/**
+ * Import a resource
+ * Imports a backend resource into the marketplace.
+ */
 export const marketplaceProviderOfferingsImportResource = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12636,7 +13382,8 @@ export const marketplaceProviderOfferingsImportResource = (options) => {
     });
 };
 /**
- * List importable resources for offering.
+ * List importable resources
+ * Returns a paginated list of resources that can be imported for this offering.
  */
 export const marketplaceProviderOfferingsImportableResourcesList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12654,7 +13401,11 @@ export const marketplaceProviderOfferingsImportableResourcesList = (options) =>
         ...options
     });
 };
-export const marketplaceProviderOfferingsListCourseAccountsRetrieve = (options) => {
+/**
+ * List course accounts for an offering
+ * Returns a paginated list of course accounts for projects that have resources of this offering.
+ */
+export const marketplaceProviderOfferingsListCourseAccountsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
             {
@@ -12670,6 +13421,10 @@ export const marketplaceProviderOfferingsListCourseAccountsRetrieve = (options)
         ...options
     });
 };
+/**
+ * List customer projects for an offering
+ * Returns a paginated list of projects that have consumed resources of this offering.
+ */
 export const marketplaceProviderOfferingsListCustomerProjectsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12686,7 +13441,11 @@ export const marketplaceProviderOfferingsListCustomerProjectsList = (options) =>
         ...options
     });
 };
-export const marketplaceProviderOfferingsListCustomerServiceAccountsRetrieve = (options) => {
+/**
+ * List customer service accounts for an offering
+ * Returns a paginated list of customer-level service accounts for customers who have resources of this offering.
+ */
+export const marketplaceProviderOfferingsListCustomerServiceAccountsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
             {
@@ -12702,6 +13461,10 @@ export const marketplaceProviderOfferingsListCustomerServiceAccountsRetrieve = (
         ...options
     });
 };
+/**
+ * List customer users for an offering
+ * Returns a paginated list of users who have access to resources of this offering.
+ */
 export const marketplaceProviderOfferingsListCustomerUsersList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12718,7 +13481,11 @@ export const marketplaceProviderOfferingsListCustomerUsersList = (options) => {
         ...options
     });
 };
-export const marketplaceProviderOfferingsListProjectServiceAccountsRetrieve = (options) => {
+/**
+ * List project service accounts for an offering
+ * Returns a paginated list of project-level service accounts for projects that have resources of this offering.
+ */
+export const marketplaceProviderOfferingsListProjectServiceAccountsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
             {
@@ -12754,6 +13521,10 @@ export const marketplaceProviderOfferingsListUsersList = (options) => {
         ...options
     });
 };
+/**
+ * Move an offering
+ * Moves an offering to a different service provider. Requires staff permissions.
+ */
 export const marketplaceProviderOfferingsMoveOffering = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12774,6 +13545,10 @@ export const marketplaceProviderOfferingsMoveOffering = (options) => {
         }
     });
 };
+/**
+ * List orders for an offering
+ * Returns a paginated list of orders associated with a specific offering.
+ */
 export const marketplaceProviderOfferingsOrdersList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12790,6 +13565,10 @@ export const marketplaceProviderOfferingsOrdersList = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a specific order for an offering
+ * Returns details of a specific order associated with an offering.
+ */
 export const marketplaceProviderOfferingsOrdersRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12806,6 +13585,10 @@ export const marketplaceProviderOfferingsOrdersRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Pause an offering
+ * Pauses an active offering, preventing new orders from being created.
+ */
 export const marketplaceProviderOfferingsPause = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12827,7 +13610,8 @@ export const marketplaceProviderOfferingsPause = (options) => {
     });
 };
 /**
- * Refresh offering user usernames.
+ * Refresh offering user usernames
+ * Triggers a refresh of usernames for all non-restricted users associated with this offering, based on the current username generation policy.
  */
 export const marketplaceProviderOfferingsRefreshOfferingUsernames = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12845,6 +13629,10 @@ export const marketplaceProviderOfferingsRefreshOfferingUsernames = (options) =>
         ...options
     });
 };
+/**
+ * Remove an offering component
+ * Removes a custom component from an offering. Built-in components cannot be removed.
+ */
 export const marketplaceProviderOfferingsRemoveOfferingComponent = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12866,7 +13654,8 @@ export const marketplaceProviderOfferingsRemoveOfferingComponent = (options) =>
     });
 };
 /**
- * Remove partition from offering.
+ * Remove a partition from an offering
+ * Removes a partition configuration from an offering.
  */
 export const marketplaceProviderOfferingsRemovePartition = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12889,7 +13678,8 @@ export const marketplaceProviderOfferingsRemovePartition = (options) => {
     });
 };
 /**
- * Remove software catalog from offering.
+ * Remove a software catalog from an offering
+ * Disassociates a software catalog from an offering.
  */
 export const marketplaceProviderOfferingsRemoveSoftwareCatalog = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -12911,6 +13701,10 @@ export const marketplaceProviderOfferingsRemoveSoftwareCatalog = (options) => {
         }
     });
 };
+/**
+ * Set offering backend metadata
+ * Updates the backend-specific metadata for an offering.
+ */
 export const marketplaceProviderOfferingsSetBackendMetadata = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12931,6 +13725,10 @@ export const marketplaceProviderOfferingsSetBackendMetadata = (options) => {
         }
     });
 };
+/**
+ * Get offering statistics
+ * Returns basic statistics for an offering, such as the number of active resources and customers.
+ */
 export const marketplaceProviderOfferingsStatsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -12947,6 +13745,10 @@ export const marketplaceProviderOfferingsStatsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Synchronize offering service settings
+ * Schedules a synchronization task to pull the latest data for the offering's service settings from the backend.
+ */
 export const marketplaceProviderOfferingsSync = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12964,7 +13766,8 @@ export const marketplaceProviderOfferingsSync = (options) => {
     });
 };
 /**
- * Return comprehensive ToS consent statistics for this offering.
+ * Get Terms of Service consent statistics
+ * Returns comprehensive Terms of Service consent statistics for this offering, including user counts, consent rates, and historical data.
  */
 export const marketplaceProviderOfferingsTosStatsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -12982,6 +13785,10 @@ export const marketplaceProviderOfferingsTosStatsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Unpause an offering
+ * Resumes a paused offering, making it available for ordering again.
+ */
 export const marketplaceProviderOfferingsUnpause = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -12999,7 +13806,8 @@ export const marketplaceProviderOfferingsUnpause = (options) => {
     });
 };
 /**
- * Update offering attributes.
+ * Update offering attributes
+ * Updates the attributes of an offering.
  */
 export const marketplaceProviderOfferingsUpdateAttributes = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13021,6 +13829,10 @@ export const marketplaceProviderOfferingsUpdateAttributes = (options) => {
         }
     });
 };
+/**
+ * Update offering compliance checklist
+ * Associates a compliance checklist with an offering.
+ */
 export const marketplaceProviderOfferingsUpdateComplianceChecklist = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13041,6 +13853,10 @@ export const marketplaceProviderOfferingsUpdateComplianceChecklist = (options) =
         }
     });
 };
+/**
+ * Update offering category
+ * Updates the category of an offering.
+ */
 export const marketplaceProviderOfferingsUpdateDescription = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13062,7 +13878,8 @@ export const marketplaceProviderOfferingsUpdateDescription = (options) => {
     });
 };
 /**
- * Update offering image.
+ * Update offering image
+ * Uploads or replaces the main image for an offering.
  */
 export const marketplaceProviderOfferingsUpdateImage = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13084,6 +13901,10 @@ export const marketplaceProviderOfferingsUpdateImage = (options) => {
         }
     });
 };
+/**
+ * Update offering integration settings
+ * Updates the backend integration settings for an offering, including plugin options, secret options, and service attributes.
+ */
 export const marketplaceProviderOfferingsUpdateIntegration = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13104,6 +13925,10 @@ export const marketplaceProviderOfferingsUpdateIntegration = (options) => {
         }
     });
 };
+/**
+ * Update offering location
+ * Updates the geographical location (latitude and longitude) of an offering.
+ */
 export const marketplaceProviderOfferingsUpdateLocation = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13124,6 +13949,10 @@ export const marketplaceProviderOfferingsUpdateLocation = (options) => {
         }
     });
 };
+/**
+ * Update an offering component
+ * Updates the properties of a specific component within an offering.
+ */
 export const marketplaceProviderOfferingsUpdateOfferingComponent = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13144,6 +13973,10 @@ export const marketplaceProviderOfferingsUpdateOfferingComponent = (options) =>
         }
     });
 };
+/**
+ * Update offering options
+ * Updates the order form options for an offering.
+ */
 export const marketplaceProviderOfferingsUpdateOptions = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13165,7 +13998,8 @@ export const marketplaceProviderOfferingsUpdateOptions = (options) => {
     });
 };
 /**
- * Update organization groups for offering.
+ * Update organization groups for offering
+ * Sets the list of organization groups that can access this offering.
  */
 export const marketplaceProviderOfferingsUpdateOrganizationGroups = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13187,6 +14021,10 @@ export const marketplaceProviderOfferingsUpdateOrganizationGroups = (options) =>
         }
     });
 };
+/**
+ * Update offering overview
+ * Updates the overview fields of an offering, such as name, description, and getting started guide.
+ */
 export const marketplaceProviderOfferingsUpdateOverview = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13208,7 +14046,8 @@ export const marketplaceProviderOfferingsUpdateOverview = (options) => {
     });
 };
 /**
- * Update partition configuration for offering.
+ * Update a partition of an offering
+ * Updates the configuration of an existing partition associated with an offering.
  */
 export const marketplaceProviderOfferingsUpdatePartitionPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
@@ -13230,6 +14069,10 @@ export const marketplaceProviderOfferingsUpdatePartitionPartialUpdate = (options
         }
     });
 };
+/**
+ * Update offering resource options
+ * Updates the resource report form options for an offering.
+ */
 export const marketplaceProviderOfferingsUpdateResourceOptions = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13251,7 +14094,8 @@ export const marketplaceProviderOfferingsUpdateResourceOptions = (options) => {
     });
 };
 /**
- * Update software catalog configuration for offering.
+ * Update software catalog configuration
+ * Updates the configuration of a software catalog associated with an offering, such as enabled architectures or partition.
  */
 export const marketplaceProviderOfferingsUpdateSoftwareCatalogPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
@@ -13274,7 +14118,8 @@ export const marketplaceProviderOfferingsUpdateSoftwareCatalogPartialUpdate = (o
     });
 };
 /**
- * Update offering thumbnail.
+ * Update offering thumbnail
+ * Uploads or replaces the thumbnail image for an offering.
  */
 export const marketplaceProviderOfferingsUpdateThumbnail = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13321,7 +14166,8 @@ export const marketplaceProviderOfferingsUpdateUser = (options) => {
     });
 };
 /**
- * Check if user has access to offering.
+ * Check user access to offering resources
+ * Checks if a specified user has access to any non-terminated resource of this offering.
  */
 export const marketplaceProviderOfferingsUserHasResourceAccessRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -13339,6 +14185,10 @@ export const marketplaceProviderOfferingsUserHasResourceAccessRetrieve = (option
         ...options
     });
 };
+/**
+ * List offerings grouped by provider
+ * Returns a paginated list of active, shared offerings grouped by their service provider.
+ */
 export const marketplaceProviderOfferingsGroupsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -13356,6 +14206,7 @@ export const marketplaceProviderOfferingsGroupsList = (options) => {
     });
 };
 /**
+ * List offerings grouped by provider
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceProviderOfferingsGroupsCount = (options) => {
@@ -13374,6 +14225,10 @@ export const marketplaceProviderOfferingsGroupsCount = (options) => {
         ...options
     });
 };
+/**
+ * List provider resources
+ * Returns a paginated list of resources for offerings managed by the current user as a service provider.
+ */
 export const marketplaceProviderResourcesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -13391,6 +14246,7 @@ export const marketplaceProviderResourcesList = (options) => {
     });
 };
 /**
+ * List provider resources
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceProviderResourcesCount = (options) => {
@@ -13409,6 +14265,10 @@ export const marketplaceProviderResourcesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a provider resource
+ * Returns details of a specific resource from a provider's perspective.
+ */
 export const marketplaceProviderResourcesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -13425,6 +14285,10 @@ export const marketplaceProviderResourcesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a provider resource
+ * Partially updates the name or description of a resource. Requires provider permissions.
+ */
 export const marketplaceProviderResourcesPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -13445,6 +14309,10 @@ export const marketplaceProviderResourcesPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a provider resource
+ * Updates the name or description of a resource. Requires provider permissions.
+ */
 export const marketplaceProviderResourcesUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -13465,6 +14333,10 @@ export const marketplaceProviderResourcesUpdate = (options) => {
         }
     });
 };
+/**
+ * Get resource details
+ * Returns the detailed representation of the backend resource associated with the marketplace resource. The format of the response depends on the resource type.
+ */
 export const marketplaceProviderResourcesDetailsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -13482,11 +14354,10 @@ export const marketplaceProviderResourcesDetailsRetrieve = (options) => {
     });
 };
 /**
+ * Get GLauth user configuration for a resource
  *
- * This endpoint provides a config file for GLauth.
- * Example: https://github.com/glauth/glauth/blob/master/v2/sample-simple.cfg
- * It is assumed that the config is used by an external agent,
- * which synchronizes data from Waldur to GLauth.
+ * This endpoint provides a GLauth configuration file for the users associated with the project of this resource.
+ * It is intended for use by an external agent to synchronize user data from Waldur to GLauth.
  *
  */
 export const marketplaceProviderResourcesGlauthUsersConfigRetrieve = (options) => {
@@ -13506,7 +14377,8 @@ export const marketplaceProviderResourcesGlauthUsersConfigRetrieve = (options) =
     });
 };
 /**
- * Move resource to another project.
+ * Move a resource to another project
+ * Moves a resource and its associated data to a different project. Requires staff permissions.
  */
 export const marketplaceProviderResourcesMoveResource = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13528,6 +14400,10 @@ export const marketplaceProviderResourcesMoveResource = (options) => {
         }
     });
 };
+/**
+ * Get offering details
+ * Returns details of the offering connected to the requested object.
+ */
 export const marketplaceProviderResourcesOfferingRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -13544,6 +14420,10 @@ export const marketplaceProviderResourcesOfferingRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List offerings for sub-resources
+ * Returns a list of offerings that can be provisioned as sub-resources of the current resource.
+ */
 export const marketplaceProviderResourcesOfferingForSubresourcesList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -13560,6 +14440,10 @@ export const marketplaceProviderResourcesOfferingForSubresourcesList = (options)
         ...options
     });
 };
+/**
+ * List resource plan periods
+ * Returns a list of active and future plan periods for the resource. Each period includes the plan details and current component usage.
+ */
 export const marketplaceProviderResourcesPlanPeriodsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -13577,7 +14461,8 @@ export const marketplaceProviderResourcesPlanPeriodsList = (options) => {
     });
 };
 /**
- * Starts process of pulling a resource
+ * Pull resource data
+ * Schedules a task to pull the latest data for the resource from its backend.
  */
 export const marketplaceProviderResourcesPull = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13596,7 +14481,8 @@ export const marketplaceProviderResourcesPull = (options) => {
     });
 };
 /**
- * Refresh the last sync time for a resource.
+ * Refresh last sync time
+ * Updates the 'last_sync' timestamp for a resource to the current time. This is useful for backend agents to signal that a resource is being actively monitored.
  */
 export const marketplaceProviderResourcesRefreshLastSync = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13615,7 +14501,8 @@ export const marketplaceProviderResourcesRefreshLastSync = (options) => {
     });
 };
 /**
- * Set the resource as erred.
+ * Set resource state to erred
+ * Allows a service provider to manually set the state of a resource to 'erred'. An error message and traceback can be provided.
  */
 export const marketplaceProviderResourcesSetAsErred = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13638,7 +14525,8 @@ export const marketplaceProviderResourcesSetAsErred = (options) => {
     });
 };
 /**
- * Set the resource as OK.
+ * Set resource state to OK
+ * Allows a service provider to manually set the state of a resource to 'OK', clearing any previous error messages.
  */
 export const marketplaceProviderResourcesSetAsOk = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13657,7 +14545,8 @@ export const marketplaceProviderResourcesSetAsOk = (options) => {
     });
 };
 /**
- * Set resource backend ID.
+ * Set resource backend ID
+ * Allows a service provider to set or update the backend ID for a resource, linking it to an external system's identifier.
  */
 export const marketplaceProviderResourcesSetBackendId = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13679,6 +14568,10 @@ export const marketplaceProviderResourcesSetBackendId = (options) => {
         }
     });
 };
+/**
+ * Set resource backend metadata
+ * Allows a service provider to set or update the backend-specific metadata for a resource.
+ */
 export const marketplaceProviderResourcesSetBackendMetadata = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13700,7 +14593,8 @@ export const marketplaceProviderResourcesSetBackendMetadata = (options) => {
     });
 };
 /**
- * Set downscaled flag for resource.
+ * Set downscaled flag for resource
+ * Sets the 'downscaled' flag for a resource. Requires staff permissions.
  */
 export const marketplaceProviderResourcesSetDownscaled = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13722,6 +14616,10 @@ export const marketplaceProviderResourcesSetDownscaled = (options) => {
         }
     });
 };
+/**
+ * Set end date by provider
+ * Allows a service provider to set or update the end date for a resource, scheduling it for termination. A notification is sent to the consumer.
+ */
 export const marketplaceProviderResourcesSetEndDateByProvider = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13743,7 +14641,8 @@ export const marketplaceProviderResourcesSetEndDateByProvider = (options) => {
     });
 };
 /**
- * Set end date of the resource by staff.
+ * Set end date of the resource by staff
+ * Allows a staff user to set or update the end date for a resource, which will schedule it for termination.
  */
 export const marketplaceProviderResourcesSetEndDateByStaff = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13765,6 +14664,10 @@ export const marketplaceProviderResourcesSetEndDateByStaff = (options) => {
         }
     });
 };
+/**
+ * Set resource limits
+ * Allows a service provider to directly set the limits for a resource. This is typically used for administrative changes or backend synchronization, bypassing the normal order process.
+ */
 export const marketplaceProviderResourcesSetLimits = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -13786,7 +14689,8 @@ export const marketplaceProviderResourcesSetLimits = (options) => {
     });
 };
 /**
- * Set paused flag for resource.
+ * Set paused flag for resource
+ * Sets the 'paused' flag for a resource. Requires staff permissions.
  */
 export const marketplaceProviderResourcesSetPaused = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13809,7 +14713,8 @@ export const marketplaceProviderResourcesSetPaused = (options) => {
     });
 };
 /**
- * Set restrict_member_access flag for resource.
+ * Set restrict member access flag
+ * Sets the 'restrict_member_access' flag for a resource. Requires staff permissions.
  */
 export const marketplaceProviderResourcesSetRestrictMemberAccess = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13832,7 +14737,8 @@ export const marketplaceProviderResourcesSetRestrictMemberAccess = (options) =>
     });
 };
 /**
- * Set slug for resource.
+ * Set resource slug
+ * Updates the slug for a resource. Requires staff permissions.
  */
 export const marketplaceProviderResourcesSetSlug = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13855,7 +14761,8 @@ export const marketplaceProviderResourcesSetSlug = (options) => {
     });
 };
 /**
- * Submit resource report.
+ * Submit a report for a resource
+ * Allows a service provider to submit a report (e.g., usage or status report) for a resource.
  */
 export const marketplaceProviderResourcesSubmitReport = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13878,7 +14785,8 @@ export const marketplaceProviderResourcesSubmitReport = (options) => {
     });
 };
 /**
- * Return users connected to the project.
+ * Get resource team
+ * Returns a list of users connected to the project of this resource, including their project roles and offering-specific usernames.
  */
 export const marketplaceProviderResourcesTeamList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -13897,7 +14805,8 @@ export const marketplaceProviderResourcesTeamList = (options) => {
     });
 };
 /**
- * Create marketplace order for resource termination.
+ * Terminate a resource
+ * Creates a marketplace order to terminate the resource. This action is asynchronous and may require approval.
  */
 export const marketplaceProviderResourcesTerminate = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13920,9 +14829,8 @@ export const marketplaceProviderResourcesTerminate = (options) => {
     });
 };
 /**
- * Delete marketplace resource and related plugin resource from the database without scheduling operations on backend
- * and without checking current state of the resource. It is intended to be used
- * for removing resource stuck in transitioning state.
+ * Unlink a resource (staff only)
+ * Forcefully deletes a marketplace resource and its related plugin resource from the database. This action does not schedule operations on the backend and is intended for cleaning up resources stuck in transitioning states. Requires staff permissions.
  */
 export const marketplaceProviderResourcesUnlink = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13941,7 +14849,8 @@ export const marketplaceProviderResourcesUnlink = (options) => {
     });
 };
 /**
- * Update resource options.
+ * Update resource options
+ * Updates the options of a resource. If the offering is configured to create orders for option changes, a new UPDATE order will be created. Otherwise, the options are updated directly.
  */
 export const marketplaceProviderResourcesUpdateOptions = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13964,7 +14873,8 @@ export const marketplaceProviderResourcesUpdateOptions = (options) => {
     });
 };
 /**
- * Update resource options directly without creating orders.
+ * Update resource options directly
+ * Allows a service provider to directly update the options of a resource without creating an order. This is typically used for administrative changes or backend synchronization.
  */
 export const marketplaceProviderResourcesUpdateOptionsDirect = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -13986,6 +14896,16 @@ export const marketplaceProviderResourcesUpdateOptionsDirect = (options) => {
         }
     });
 };
+/**
+ * Check service provider signature
+ *
+ * Validates a signed payload from a service provider. The payload is a JWT token
+ * signed with the provider's API secret code. This endpoint is used to verify the
+ * authenticity of a request before processing it.
+ *
+ * The `data` field should contain the JWT token.
+ *
+ */
 export const marketplacePublicApiCheckSignature = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -14006,6 +14926,16 @@ export const marketplacePublicApiCheckSignature = (options) => {
         }
     });
 };
+/**
+ * Set component usage with signature
+ *
+ * Allows a service provider to report usage for resource components using a signed JWT payload.
+ * This provides a secure way for external systems to submit billing data.
+ *
+ * The `data` field must contain a JWT token that, when decoded, matches the structure of the
+ * `ComponentUsageCreateSerializer`.
+ *
+ */
 export const marketplacePublicApiSetUsage = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -14026,6 +14956,10 @@ export const marketplacePublicApiSetUsage = (options) => {
         }
     });
 };
+/**
+ * List public offerings
+ * Returns a paginated list of public offerings. The list is filtered to show only offerings that are active or paused and available for ordering by the current user. If anonymous access is enabled, it shows shared offerings available to unauthenticated users.
+ */
 export const marketplacePublicOfferingsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -14043,6 +14977,7 @@ export const marketplacePublicOfferingsList = (options) => {
     });
 };
 /**
+ * List public offerings
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplacePublicOfferingsCount = (options) => {
@@ -14061,6 +14996,10 @@ export const marketplacePublicOfferingsCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a public offering
+ * Returns the details of a specific public offering. Access is granted if the offering is available for ordering by the current user or if anonymous access is enabled.
+ */
 export const marketplacePublicOfferingsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14077,6 +15016,10 @@ export const marketplacePublicOfferingsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List plans for an offering
+ * Returns a list of plans available for a specific offering. The plans are filtered based on the current user's permissions and organization group memberships.
+ */
 export const marketplacePublicOfferingsPlansList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14093,6 +15036,10 @@ export const marketplacePublicOfferingsPlansList = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a specific plan for an offering
+ * Returns the details of a specific plan if it is available to the current user for the given offering.
+ */
 export const marketplacePublicOfferingsPlansRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14284,6 +15231,10 @@ export const marketplaceResourceOfferingsList = (options) => {
         ...options
     });
 };
+/**
+ * List resource users
+ * Returns a paginated list of users associated with resources, including their roles. The list is filtered based on the permissions of the current user. Staff and support users can see all resource-user links. Other users can only see links for resources they have access to.
+ */
 export const marketplaceResourceUsersList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -14301,6 +15252,7 @@ export const marketplaceResourceUsersList = (options) => {
     });
 };
 /**
+ * List resource users
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceResourceUsersCount = (options) => {
@@ -14319,6 +15271,10 @@ export const marketplaceResourceUsersCount = (options) => {
         ...options
     });
 };
+/**
+ * Link a user to a resource
+ * Creates a new association between a user and a resource with a specific role. The user must have permission to manage users for the resource (typically service provider staff or owners).
+ */
 export const marketplaceResourceUsersCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -14339,6 +15295,10 @@ export const marketplaceResourceUsersCreate = (options) => {
         }
     });
 };
+/**
+ * Unlink a user from a resource
+ * Removes the association between a user and a resource, effectively revoking their role on that resource. The user must have permission to manage users for the resource.
+ */
 export const marketplaceResourceUsersDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -14355,6 +15315,10 @@ export const marketplaceResourceUsersDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a resource-user link
+ * Returns details of a specific link between a user and a resource, including their role.
+ */
 export const marketplaceResourceUsersRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14371,6 +15335,10 @@ export const marketplaceResourceUsersRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List consumer resources
+ * Returns a paginated list of resources accessible to the current user as a service consumer.
+ */
 export const marketplaceResourcesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -14388,6 +15356,7 @@ export const marketplaceResourcesList = (options) => {
     });
 };
 /**
+ * List consumer resources
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceResourcesCount = (options) => {
@@ -14406,6 +15375,10 @@ export const marketplaceResourcesCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a consumer resource
+ * Returns details of a specific resource accessible to the consumer.
+ */
 export const marketplaceResourcesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14422,6 +15395,10 @@ export const marketplaceResourcesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a consumer resource
+ * Partially updates the name, description, or end date of a resource.
+ */
 export const marketplaceResourcesPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -14442,6 +15419,10 @@ export const marketplaceResourcesPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a consumer resource
+ * Updates the name, description, or end date of a resource.
+ */
 export const marketplaceResourcesUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -14462,6 +15443,10 @@ export const marketplaceResourcesUpdate = (options) => {
         }
     });
 };
+/**
+ * Get resource details
+ * Returns the detailed representation of the backend resource associated with the marketplace resource. The format of the response depends on the resource type.
+ */
 export const marketplaceResourcesDetailsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14479,11 +15464,10 @@ export const marketplaceResourcesDetailsRetrieve = (options) => {
     });
 };
 /**
+ * Get GLauth user configuration for a resource
  *
- * This endpoint provides a config file for GLauth.
- * Example: https://github.com/glauth/glauth/blob/master/v2/sample-simple.cfg
- * It is assumed that the config is used by an external agent,
- * which synchronizes data from Waldur to GLauth.
+ * This endpoint provides a GLauth configuration file for the users associated with the project of this resource.
+ * It is intended for use by an external agent to synchronize user data from Waldur to GLauth.
  *
  */
 export const marketplaceResourcesGlauthUsersConfigRetrieve = (options) => {
@@ -14503,7 +15487,8 @@ export const marketplaceResourcesGlauthUsersConfigRetrieve = (options) => {
     });
 };
 /**
- * Move resource to another project.
+ * Move a resource to another project
+ * Moves a resource and its associated data to a different project. Requires staff permissions.
  */
 export const marketplaceResourcesMoveResource = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14525,6 +15510,10 @@ export const marketplaceResourcesMoveResource = (options) => {
         }
     });
 };
+/**
+ * Get offering details
+ * Returns details of the offering connected to the requested object.
+ */
 export const marketplaceResourcesOfferingRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14541,6 +15530,10 @@ export const marketplaceResourcesOfferingRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List offerings for sub-resources
+ * Returns a list of offerings that can be provisioned as sub-resources of the current resource.
+ */
 export const marketplaceResourcesOfferingForSubresourcesList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14557,6 +15550,10 @@ export const marketplaceResourcesOfferingForSubresourcesList = (options) => {
         ...options
     });
 };
+/**
+ * List resource plan periods
+ * Returns a list of active and future plan periods for the resource. Each period includes the plan details and current component usage.
+ */
 export const marketplaceResourcesPlanPeriodsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14574,7 +15571,8 @@ export const marketplaceResourcesPlanPeriodsList = (options) => {
     });
 };
 /**
- * Starts process of pulling a resource
+ * Pull resource data
+ * Schedules a task to pull the latest data for the resource from its backend.
  */
 export const marketplaceResourcesPull = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14593,7 +15591,8 @@ export const marketplaceResourcesPull = (options) => {
     });
 };
 /**
- * Create a renewal order for a prepaid resource.
+ * Renew a prepaid resource
+ * Creates a renewal order to extend the subscription period of a prepaid resource. Optionally, limits can be upgraded at the same time.
  */
 export const marketplaceResourcesRenew = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14616,7 +15615,8 @@ export const marketplaceResourcesRenew = (options) => {
     });
 };
 /**
- * Set downscaled flag for resource.
+ * Set downscaled flag for resource
+ * Sets the 'downscaled' flag for a resource. Requires staff permissions.
  */
 export const marketplaceResourcesSetDownscaled = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14639,7 +15639,8 @@ export const marketplaceResourcesSetDownscaled = (options) => {
     });
 };
 /**
- * Set end date of the resource by staff.
+ * Set end date of the resource by staff
+ * Allows a staff user to set or update the end date for a resource, which will schedule it for termination.
  */
 export const marketplaceResourcesSetEndDateByStaff = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14662,7 +15663,8 @@ export const marketplaceResourcesSetEndDateByStaff = (options) => {
     });
 };
 /**
- * Set paused flag for resource.
+ * Set paused flag for resource
+ * Sets the 'paused' flag for a resource. Requires staff permissions.
  */
 export const marketplaceResourcesSetPaused = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14685,7 +15687,8 @@ export const marketplaceResourcesSetPaused = (options) => {
     });
 };
 /**
- * Set restrict_member_access flag for resource.
+ * Set restrict member access flag
+ * Sets the 'restrict_member_access' flag for a resource. Requires staff permissions.
  */
 export const marketplaceResourcesSetRestrictMemberAccess = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14708,7 +15711,8 @@ export const marketplaceResourcesSetRestrictMemberAccess = (options) => {
     });
 };
 /**
- * Set slug for resource.
+ * Set resource slug
+ * Updates the slug for a resource. Requires staff permissions.
  */
 export const marketplaceResourcesSetSlug = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14731,7 +15735,8 @@ export const marketplaceResourcesSetSlug = (options) => {
     });
 };
 /**
- * Create marketplace order for resource plan switch.
+ * Switch resource plan
+ * Creates a marketplace order to switch the billing plan for a resource. This action is asynchronous and may require approval.
  */
 export const marketplaceResourcesSwitchPlan = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14754,7 +15759,8 @@ export const marketplaceResourcesSwitchPlan = (options) => {
     });
 };
 /**
- * Return users connected to the project.
+ * Get resource team
+ * Returns a list of users connected to the project of this resource, including their project roles and offering-specific usernames.
  */
 export const marketplaceResourcesTeamList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -14773,7 +15779,8 @@ export const marketplaceResourcesTeamList = (options) => {
     });
 };
 /**
- * Create marketplace order for resource termination.
+ * Terminate a resource
+ * Creates a marketplace order to terminate the resource. This action is asynchronous and may require approval.
  */
 export const marketplaceResourcesTerminate = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14796,9 +15803,8 @@ export const marketplaceResourcesTerminate = (options) => {
     });
 };
 /**
- * Delete marketplace resource and related plugin resource from the database without scheduling operations on backend
- * and without checking current state of the resource. It is intended to be used
- * for removing resource stuck in transitioning state.
+ * Unlink a resource (staff only)
+ * Forcefully deletes a marketplace resource and its related plugin resource from the database. This action does not schedule operations on the backend and is intended for cleaning up resources stuck in transitioning states. Requires staff permissions.
  */
 export const marketplaceResourcesUnlink = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14817,7 +15823,8 @@ export const marketplaceResourcesUnlink = (options) => {
     });
 };
 /**
- * Create marketplace order for resource limits update.
+ * Update resource limits
+ * Creates a marketplace order to update the limits (e.g., CPU, RAM) for a resource. This action is asynchronous and may require approval.
  */
 export const marketplaceResourcesUpdateLimits = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14840,7 +15847,8 @@ export const marketplaceResourcesUpdateLimits = (options) => {
     });
 };
 /**
- * Update resource options.
+ * Update resource options
+ * Updates the options of a resource. If the offering is configured to create orders for option changes, a new UPDATE order will be created. Otherwise, the options are updated directly.
  */
 export const marketplaceResourcesUpdateOptions = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -14862,6 +15870,10 @@ export const marketplaceResourcesUpdateOptions = (options) => {
         }
     });
 };
+/**
+ * Suggest a resource name
+ * Generates a suggested name for a new resource based on the project and offering.
+ */
 export const marketplaceResourcesSuggestName = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -14882,6 +15894,10 @@ export const marketplaceResourcesSuggestName = (options) => {
         }
     });
 };
+/**
+ * List robot accounts
+ * Returns a paginated list of robot accounts accessible to the current user.
+ */
 export const marketplaceRobotAccountsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -14899,6 +15915,7 @@ export const marketplaceRobotAccountsList = (options) => {
     });
 };
 /**
+ * List robot accounts
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceRobotAccountsCount = (options) => {
@@ -14917,6 +15934,10 @@ export const marketplaceRobotAccountsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a robot account
+ * Creates a new robot account for a specific resource. This is typically used for automated access to a resource, e.g., for CI/CD pipelines.
+ */
 export const marketplaceRobotAccountsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -14937,6 +15958,10 @@ export const marketplaceRobotAccountsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a robot account
+ * Deletes a robot account. This is a hard delete and should be used with caution.
+ */
 export const marketplaceRobotAccountsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -14953,6 +15978,10 @@ export const marketplaceRobotAccountsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a robot account
+ * Returns the details of a specific robot account.
+ */
 export const marketplaceRobotAccountsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -14969,6 +15998,10 @@ export const marketplaceRobotAccountsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a robot account
+ * Partially updates the properties of a robot account. Not allowed for synchronized remote accounts.
+ */
 export const marketplaceRobotAccountsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -14989,6 +16022,10 @@ export const marketplaceRobotAccountsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a robot account
+ * Updates the properties of a robot account, such as its username or associated users. Not allowed for synchronized remote accounts.
+ */
 export const marketplaceRobotAccountsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -15009,6 +16046,10 @@ export const marketplaceRobotAccountsUpdate = (options) => {
         }
     });
 };
+/**
+ * Set robot account state to creating
+ * Transitions the robot account state from 'Requested' to 'Creating'. This is typically used by an agent to signal that the creation process has started.
+ */
 export const marketplaceRobotAccountsSetStateCreating = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15025,6 +16066,10 @@ export const marketplaceRobotAccountsSetStateCreating = (options) => {
         ...options
     });
 };
+/**
+ * Set robot account state to deleted
+ * Transitions the robot account state from 'Requested deletion' to 'Deleted', marking the successful completion of the deletion process.
+ */
 export const marketplaceRobotAccountsSetStateDeleted = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15041,6 +16086,10 @@ export const marketplaceRobotAccountsSetStateDeleted = (options) => {
         ...options
     });
 };
+/**
+ * Set robot account state to erred
+ * Manually moves the robot account into the 'Error' state. An optional error message can be provided.
+ */
 export const marketplaceRobotAccountsSetStateErred = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15061,6 +16110,10 @@ export const marketplaceRobotAccountsSetStateErred = (options) => {
         }
     });
 };
+/**
+ * Set robot account state to OK
+ * Manually sets the robot account state to 'OK', indicating that it is fully operational. This can be used to recover from an error state.
+ */
 export const marketplaceRobotAccountsSetStateOk = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15077,6 +16130,10 @@ export const marketplaceRobotAccountsSetStateOk = (options) => {
         ...options
     });
 };
+/**
+ * Request deletion of a robot account
+ * Transitions the robot account state from 'OK' to 'Requested deletion', initiating the deletion process.
+ */
 export const marketplaceRobotAccountsSetStateRequestDeletion = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15094,7 +16151,13 @@ export const marketplaceRobotAccountsSetStateRequestDeletion = (options) => {
     });
 };
 /**
- * Retrieve available runtime states for resources, optionally filtered by project and category.
+ * List available runtime states for resources
+ *
+ * Returns a unique, sorted list of runtime states for all resources accessible to the current user.
+ * The runtime state is a backend-specific state of a resource (e.g., 'ACTIVE', 'SHUTOFF' for a VM).
+ * This endpoint is useful for building dynamic filters in a user interface.
+ * The list can be optionally filtered by project or category.
+ *
  */
 export const marketplaceRuntimeStatesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
@@ -15356,6 +16419,10 @@ export const marketplaceScriptSyncResource = (options) => {
         }
     });
 };
+/**
+ * List sections
+ * Returns a paginated list of all sections. Sections are used to group attributes within a category.
+ */
 export const marketplaceSectionsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -15373,6 +16440,7 @@ export const marketplaceSectionsList = (options) => {
     });
 };
 /**
+ * List sections
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceSectionsCount = (options) => {
@@ -15391,6 +16459,10 @@ export const marketplaceSectionsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a section
+ * Creates a new section within a category. Requires staff permissions.
+ */
 export const marketplaceSectionsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15411,6 +16483,10 @@ export const marketplaceSectionsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a section
+ * Deletes a section. Requires staff permissions.
+ */
 export const marketplaceSectionsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -15427,6 +16503,10 @@ export const marketplaceSectionsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a section
+ * Returns the details of a specific section, identified by its key.
+ */
 export const marketplaceSectionsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -15443,6 +16523,10 @@ export const marketplaceSectionsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a section
+ * Partially updates an existing section. Requires staff permissions.
+ */
 export const marketplaceSectionsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -15463,6 +16547,10 @@ export const marketplaceSectionsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a section
+ * Updates an existing section. Requires staff permissions.
+ */
 export const marketplaceSectionsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -15483,6 +16571,10 @@ export const marketplaceSectionsUpdate = (options) => {
         }
     });
 };
+/**
+ * List service providers
+ * Returns a paginated list of service providers.
+ */
 export const marketplaceServiceProvidersList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -15500,6 +16592,7 @@ export const marketplaceServiceProvidersList = (options) => {
     });
 };
 /**
+ * List service providers
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceServiceProvidersCount = (options) => {
@@ -15518,6 +16611,10 @@ export const marketplaceServiceProvidersCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a service provider
+ * Creates a new service provider profile for a customer.
+ */
 export const marketplaceServiceProvidersCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -15539,7 +16636,8 @@ export const marketplaceServiceProvidersCreate = (options) => {
     });
 };
 /**
- * Get summary of all compliance checklists used by this service provider with usage counts.
+ * Get summary of compliance checklists
+ * Returns a summary of all compliance checklists used by this service provider with usage counts.
  */
 export const serviceProviderChecklistsSummary = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15558,7 +16656,8 @@ export const serviceProviderChecklistsSummary = (options) => {
     });
 };
 /**
- * Get compliance overview statistics for all offerings managed by this service provider.
+ * Get compliance overview for a service provider
+ * Returns compliance overview statistics for all offerings managed by this service provider.
  */
 export const serviceProviderComplianceOverview = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15577,7 +16676,8 @@ export const serviceProviderComplianceOverview = (options) => {
     });
 };
 /**
- * List offering users with their compliance status for this service provider.
+ * List offering users' compliance status
+ * Returns a list of offering users with their compliance status for this service provider. Can be filtered by offering and compliance status.
  */
 export const serviceProviderOfferingUsersCompliance = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15596,12 +16696,12 @@ export const serviceProviderOfferingUsersCompliance = (options) => {
     });
 };
 /**
- * Return course project accounts that have access to resources managed by the provider.
- *
- * Checks for:
- * - Projects with active service provider's resources
- * - Course accounts with non-blank users
+ * List course project accounts for a service provider
+ * Returns a paginated list of course project accounts that have access to resources managed by the provider.
  *
+ * This includes:
+ * - Projects with active resources of the service provider.
+ * - Course accounts with non-blank users.
  *
  */
 export const marketplaceServiceProvidersCourseAccountsList = (options) => {
@@ -15621,7 +16721,8 @@ export const marketplaceServiceProvidersCourseAccountsList = (options) => {
     });
 };
 /**
- * Return customer projects of service provider.
+ * List customer projects of a service provider
+ * Returns a paginated list of projects belonging to a specific customer that have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersCustomerProjectsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15640,7 +16741,8 @@ export const marketplaceServiceProvidersCustomerProjectsList = (options) => {
     });
 };
 /**
- * Return customers of service provider.
+ * List customers of a service provider
+ * Returns a paginated list of customers who have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersCustomersList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15659,7 +16761,8 @@ export const marketplaceServiceProvidersCustomersList = (options) => {
     });
 };
 /**
- * Return SSH keys of service provider.
+ * List SSH keys of a service provider
+ * Returns a paginated list of SSH public keys for all users who have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersKeysList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15678,7 +16781,8 @@ export const marketplaceServiceProvidersKeysList = (options) => {
     });
 };
 /**
- * Return offerings of service provider.
+ * List offerings of a service provider
+ * Returns a paginated list of all billable, shared offerings provided by the specified service provider.
  */
 export const marketplaceServiceProvidersOfferingsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15697,7 +16801,8 @@ export const marketplaceServiceProvidersOfferingsList = (options) => {
     });
 };
 /**
- * Return project permissions of service provider.
+ * List project permissions of a service provider
+ * Returns a paginated list of project permissions for all projects that have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersProjectPermissionsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15716,12 +16821,12 @@ export const marketplaceServiceProvidersProjectPermissionsList = (options) => {
     });
 };
 /**
- * Return project service accounts that have access to resources managed by the provider.
- *
- * Checks for:
- * - Projects with active service provider's resources
- * - Service accounts with non-blank usernames
+ * List project service accounts for a service provider
+ * Returns a paginated list of project service accounts that have access to resources managed by the provider.
  *
+ * This includes:
+ * - Projects with active resources of the service provider.
+ * - Service accounts with non-blank usernames.
  *
  */
 export const marketplaceServiceProvidersProjectServiceAccountsList = (options) => {
@@ -15741,7 +16846,8 @@ export const marketplaceServiceProvidersProjectServiceAccountsList = (options) =
     });
 };
 /**
- * Return projects of service provider.
+ * List projects of a service provider
+ * Returns a paginated list of all projects that have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersProjectsList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15760,14 +16866,14 @@ export const marketplaceServiceProvidersProjectsList = (options) => {
     });
 };
 /**
- * Return customers that have access role for a specified user within service provider's scope.
+ * List customers of a specific user within a service provider's scope
+ * Returns a paginated list of customers that a specified user has access to within the scope of a service provider.
  *
- * Checks for:
- * - Customers where user has direct permissions
- * - Customers with projects where user has project roles
- * - Customers related to service provider's resources
+ * This includes:
+ * - Customers where the user has direct permissions.
+ * - Customers with projects where the user has project roles.
+ * - Customers related to the service provider's resources that the user can access.
  *
- * If user UUID is invalid or missing, returns empty list.
  */
 export const marketplaceServiceProvidersUserCustomersList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15786,7 +16892,8 @@ export const marketplaceServiceProvidersUserCustomersList = (options) => {
     });
 };
 /**
- * Return users of service provider.
+ * List users of a service provider
+ * Returns a paginated list of all users who have consumed resources from the specified service provider.
  */
 export const marketplaceServiceProvidersUsersList = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15804,6 +16911,10 @@ export const marketplaceServiceProvidersUsersList = (options) => {
         ...options
     });
 };
+/**
+ * Delete a service provider
+ * Deletes a service provider profile. Only possible if there are no active offerings.
+ */
 export const marketplaceServiceProvidersDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -15820,6 +16931,10 @@ export const marketplaceServiceProvidersDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a service provider
+ * Returns details of a specific service provider.
+ */
 export const marketplaceServiceProvidersRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -15836,6 +16951,10 @@ export const marketplaceServiceProvidersRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a service provider
+ * Partially updates an existing service provider profile.
+ */
 export const marketplaceServiceProvidersPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -15856,6 +16975,10 @@ export const marketplaceServiceProvidersPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a service provider
+ * Updates an existing service provider profile.
+ */
 export const marketplaceServiceProvidersUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -15901,7 +17024,8 @@ export const marketplaceServiceProvidersAddUser = (options) => {
     });
 };
 /**
- * Return service provider API secret code.
+ * Get service provider API secret code
+ * Returns the API secret code for a service provider. Requires service provider owner permission.
  */
 export const serviceProviderApiSecretCodeRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -15920,7 +17044,8 @@ export const serviceProviderApiSecretCodeRetrieve = (options) => {
     });
 };
 /**
- * Generate new service provider API secret code.
+ * Generate new service provider API secret code
+ * Generates a new API secret code for a service provider, invalidating the old one. Requires service provider owner permission.
  */
 export const serviceProviderApiSecretCodeGenerate = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -15982,6 +17107,10 @@ export const marketplaceServiceProvidersListUsersList = (options) => {
         ...options
     });
 };
+/**
+ * Get service provider revenue
+ * Returns monthly revenue data for the last year for the service provider.
+ */
 export const marketplaceServiceProvidersRevenueList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -15998,6 +17127,10 @@ export const marketplaceServiceProvidersRevenueList = (options) => {
         ...options
     });
 };
+/**
+ * List customers with robot accounts
+ * Returns a paginated list of customers who have robot accounts for resources managed by this service provider.
+ */
 export const marketplaceServiceProvidersRobotAccountCustomersList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16014,6 +17147,10 @@ export const marketplaceServiceProvidersRobotAccountCustomersList = (options) =>
         ...options
     });
 };
+/**
+ * List projects with robot accounts
+ * Returns a paginated list of projects which have robot accounts for resources managed by this service provider.
+ */
 export const marketplaceServiceProvidersRobotAccountProjectsList = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16030,6 +17167,10 @@ export const marketplaceServiceProvidersRobotAccountProjectsList = (options) =>
         ...options
     });
 };
+/**
+ * Set offering username for a user
+ * Sets or updates the offering-specific username for a user across all offerings managed by the service provider that the user has access to.
+ */
 export const marketplaceServiceProvidersSetOfferingsUsername = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -16050,6 +17191,10 @@ export const marketplaceServiceProvidersSetOfferingsUsername = (options) => {
         }
     });
 };
+/**
+ * Get service provider statistics
+ * Returns various statistics for the service provider, such as number of active campaigns, customers, and resources.
+ */
 export const marketplaceServiceProvidersStatRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16553,6 +17698,10 @@ export const marketplaceSlurmPeriodicUsagePoliciesActionsCount = (options) => {
         ...options
     });
 };
+/**
+ * List software catalogs
+ * Returns a paginated list of available software catalogs, such as EESSI or Spack.
+ */
 export const marketplaceSoftwareCatalogsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -16570,6 +17719,7 @@ export const marketplaceSoftwareCatalogsList = (options) => {
     });
 };
 /**
+ * List software catalogs
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceSoftwareCatalogsCount = (options) => {
@@ -16588,6 +17738,10 @@ export const marketplaceSoftwareCatalogsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a software catalog
+ * Creates a new software catalog. Requires staff permissions.
+ */
 export const marketplaceSoftwareCatalogsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -16608,6 +17762,10 @@ export const marketplaceSoftwareCatalogsCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a software catalog
+ * Deletes a software catalog. Requires staff permissions.
+ */
 export const marketplaceSoftwareCatalogsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -16624,6 +17782,10 @@ export const marketplaceSoftwareCatalogsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a software catalog
+ * Returns the details of a specific software catalog, including its name, version, and the number of packages it contains.
+ */
 export const marketplaceSoftwareCatalogsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16640,6 +17802,10 @@ export const marketplaceSoftwareCatalogsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a software catalog
+ * Partially updates an existing software catalog. Requires staff permissions.
+ */
 export const marketplaceSoftwareCatalogsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -16660,6 +17826,10 @@ export const marketplaceSoftwareCatalogsPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a software catalog
+ * Updates an existing software catalog. Requires staff permissions.
+ */
 export const marketplaceSoftwareCatalogsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -16680,6 +17850,10 @@ export const marketplaceSoftwareCatalogsUpdate = (options) => {
         }
     });
 };
+/**
+ * List software packages
+ * Returns a paginated list of software packages available in the catalogs. Can be filtered by catalog, offering, or various package attributes.
+ */
 export const marketplaceSoftwarePackagesList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -16697,6 +17871,7 @@ export const marketplaceSoftwarePackagesList = (options) => {
     });
 };
 /**
+ * List software packages
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceSoftwarePackagesCount = (options) => {
@@ -16715,6 +17890,10 @@ export const marketplaceSoftwarePackagesCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a software package
+ * Creates a new software package within a catalog. Requires staff permissions.
+ */
 export const marketplaceSoftwarePackagesCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -16735,6 +17914,10 @@ export const marketplaceSoftwarePackagesCreate = (options) => {
         }
     });
 };
+/**
+ * Delete a software package
+ * Deletes a software package. Requires staff permissions.
+ */
 export const marketplaceSoftwarePackagesDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -16751,6 +17934,10 @@ export const marketplaceSoftwarePackagesDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a software package
+ * Returns the details of a specific software package, including its description, homepage, and available versions.
+ */
 export const marketplaceSoftwarePackagesRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16767,6 +17954,10 @@ export const marketplaceSoftwarePackagesRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a software package
+ * Partially updates an existing software package. Requires staff permissions.
+ */
 export const marketplaceSoftwarePackagesPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -16787,6 +17978,10 @@ export const marketplaceSoftwarePackagesPartialUpdate = (options) => {
         }
     });
 };
+/**
+ * Update a software package
+ * Updates an existing software package. Requires staff permissions.
+ */
 export const marketplaceSoftwarePackagesUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -16807,6 +18002,10 @@ export const marketplaceSoftwarePackagesUpdate = (options) => {
         }
     });
 };
+/**
+ * List software targets
+ * Returns a paginated list of software targets, which represent specific builds of a software version for a given CPU architecture.
+ */
 export const marketplaceSoftwareTargetsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -16824,6 +18023,7 @@ export const marketplaceSoftwareTargetsList = (options) => {
     });
 };
 /**
+ * List software targets
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceSoftwareTargetsCount = (options) => {
@@ -16842,6 +18042,10 @@ export const marketplaceSoftwareTargetsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a software target
+ * Creates a new target for a software version. Requires staff permissions.
+ */
 export const marketplaceSoftwareTargetsCreate = (options) => {
     return (options?.client ?? _heyApiClient).post({
         security: [
@@ -16858,6 +18062,10 @@ export const marketplaceSoftwareTargetsCreate = (options) => {
         ...options
     });
 };
+/**
+ * Delete a software target
+ * Deletes a software target. Requires staff permissions.
+ */
 export const marketplaceSoftwareTargetsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -16874,6 +18082,10 @@ export const marketplaceSoftwareTargetsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a software target
+ * Returns the details of a specific software target, including its CPU family, microarchitecture, and path.
+ */
 export const marketplaceSoftwareTargetsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -16890,6 +18102,10 @@ export const marketplaceSoftwareTargetsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a software target
+ * Partially updates an existing software target. Requires staff permissions.
+ */
 export const marketplaceSoftwareTargetsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -16906,6 +18122,10 @@ export const marketplaceSoftwareTargetsPartialUpdate = (options) => {
         ...options
     });
 };
+/**
+ * Update a software target
+ * Updates an existing software target. Requires staff permissions.
+ */
 export const marketplaceSoftwareTargetsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -16922,6 +18142,10 @@ export const marketplaceSoftwareTargetsUpdate = (options) => {
         ...options
     });
 };
+/**
+ * List software versions
+ * Returns a paginated list of software versions. Can be filtered by package, catalog, offering, or CPU architecture.
+ */
 export const marketplaceSoftwareVersionsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -16939,6 +18163,7 @@ export const marketplaceSoftwareVersionsList = (options) => {
     });
 };
 /**
+ * List software versions
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceSoftwareVersionsCount = (options) => {
@@ -16957,6 +18182,10 @@ export const marketplaceSoftwareVersionsCount = (options) => {
         ...options
     });
 };
+/**
+ * Create a software version
+ * Creates a new version for a software package. Requires staff permissions.
+ */
 export const marketplaceSoftwareVersionsCreate = (options) => {
     return (options?.client ?? _heyApiClient).post({
         security: [
@@ -16973,6 +18202,10 @@ export const marketplaceSoftwareVersionsCreate = (options) => {
         ...options
     });
 };
+/**
+ * Delete a software version
+ * Deletes a software version. Requires staff permissions.
+ */
 export const marketplaceSoftwareVersionsDestroy = (options) => {
     return (options.client ?? _heyApiClient).delete({
         security: [
@@ -16989,6 +18222,10 @@ export const marketplaceSoftwareVersionsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a software version
+ * Returns the details of a specific software version, including its release date and target count.
+ */
 export const marketplaceSoftwareVersionsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -17005,6 +18242,10 @@ export const marketplaceSoftwareVersionsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * Partially update a software version
+ * Partially updates an existing software version. Requires staff permissions.
+ */
 export const marketplaceSoftwareVersionsPartialUpdate = (options) => {
     return (options.client ?? _heyApiClient).patch({
         security: [
@@ -17021,6 +18262,10 @@ export const marketplaceSoftwareVersionsPartialUpdate = (options) => {
         ...options
     });
 };
+/**
+ * Update a software version
+ * Updates an existing software version. Requires staff permissions.
+ */
 export const marketplaceSoftwareVersionsUpdate = (options) => {
     return (options.client ?? _heyApiClient).put({
         security: [
@@ -17873,6 +19118,10 @@ export const marketplaceStatsTotalCostOfActiveResourcesPerOfferingCount = (optio
         ...options
     });
 };
+/**
+ * List user offering consents
+ * Returns a paginated list of Terms of Service consents for the current user. Staff and support users can see all consents.
+ */
 export const marketplaceUserOfferingConsentsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -17890,6 +19139,7 @@ export const marketplaceUserOfferingConsentsList = (options) => {
     });
 };
 /**
+ * List user offering consents
  * Get number of items in the collection matching the request parameters.
  */
 export const marketplaceUserOfferingConsentsCount = (options) => {
@@ -17908,6 +19158,10 @@ export const marketplaceUserOfferingConsentsCount = (options) => {
         ...options
     });
 };
+/**
+ * Grant consent to an offering's Terms of Service
+ * Creates a consent record for the current user and a specific offering. This indicates that the user has accepted the active Terms of Service for that offering. If a consent already exists (even if revoked), it will be reactivated and updated with the current ToS version.
+ */
 export const marketplaceUserOfferingConsentsCreate = (options) => {
     return (options.client ?? _heyApiClient).post({
         security: [
@@ -17944,6 +19198,10 @@ export const marketplaceUserOfferingConsentsDestroy = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a user offering consent
+ * Returns the details of a specific consent record.
+ */
 export const marketplaceUserOfferingConsentsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [
@@ -18001,7 +19259,8 @@ export const marketplaceUserOfferingConsentsUpdate = (options) => {
     });
 };
 /**
- * Revoke consent to Terms of Service for an offering.
+ * Revoke consent to Terms of Service
+ * Revokes a user's consent to the Terms of Service for an offering. The consent record is marked with a revocation date, and the user may lose access to related resources if consent is required.
  */
 export const marketplaceUserOfferingConsentsRevoke = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -27813,6 +29072,10 @@ export const providerInvoiceItemsRetrieve = (options) => {
         ...options
     });
 };
+/**
+ * List public maintenance announcements
+ * Returns a paginated list of public maintenance announcements. Only announcements that are 'Scheduled', 'In progress', or 'Completed' are visible. This endpoint is accessible to unauthenticated users.
+ */
 export const publicMaintenanceAnnouncementsList = (options) => {
     return (options?.client ?? _heyApiClient).get({
         security: [
@@ -27830,6 +29093,7 @@ export const publicMaintenanceAnnouncementsList = (options) => {
     });
 };
 /**
+ * List public maintenance announcements
  * Get number of items in the collection matching the request parameters.
  */
 export const publicMaintenanceAnnouncementsCount = (options) => {
@@ -27848,6 +29112,10 @@ export const publicMaintenanceAnnouncementsCount = (options) => {
         ...options
     });
 };
+/**
+ * Retrieve a public maintenance announcement
+ * Returns the details of a specific public maintenance announcement.
+ */
 export const publicMaintenanceAnnouncementsRetrieve = (options) => {
     return (options.client ?? _heyApiClient).get({
         security: [