@sailpoint/api-client 2.2.51 → 2.2.52

package/dist/machine_identities_lifecycle_actions/api.js

@@ -78,13 +78,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MachineIdentityLifecycleActionsApi = exports.MachineIdentityLifecycleActionsApiFactory = exports.MachineIdentityLifecycleActionsApiFp = exports.MachineIdentityLifecycleActionsApiAxiosParamCreator = exports.LocaleOrigin = exports.Lifecyclestatus = exports.Lifecycleprovisioningstatus = exports.Lifecycleaction = exports.LifecycleOwnerReferenceTypeEnum = exports.LifecycleCommentAuthorReferenceTypeEnum = exports.LifecycleActionRequestTargetTypeEnum = void 0;
+exports.MachineIdentityLifecycleActionsApi = exports.MachineIdentityLifecycleActionsApiFactory = exports.MachineIdentityLifecycleActionsApiFp = exports.MachineIdentityLifecycleActionsApiAxiosParamCreator = exports.LocaleOrigin = exports.Lifecyclestatus = exports.Lifecycleprovisioningstatus = exports.Lifecycleaction = exports.LifecycleOwnerReferenceTypeEnum = exports.LifecycleCommentAuthorReferenceTypeEnum = exports.LifecycleActionRequestTargetTypeEnum = exports.CancelLifecycleActionResponseStatusEnum = void 0;
 var axios_1 = __importDefault(require("axios"));
 // Some imports not used depending on template conditions
 // @ts-ignore
 var common_1 = require("./common");
 // @ts-ignore
 var base_1 = require("./base");
+exports.CancelLifecycleActionResponseStatusEnum = {
+    Canceling: 'CANCELING'
+};
 exports.LifecycleActionRequestTargetTypeEnum = {
     AiAgent: 'AI_AGENT'
 };
@@ -108,7 +111,7 @@ exports.Lifecycleaction = {
     Activate: 'ACTIVATE'
 };
 /**
- * Provisioning execution status for the downstream workflow window.
+ * Status of provisioning the change to the machine identity\'s source.
  * @export
  * @enum {string}
  */
@@ -119,7 +122,7 @@ exports.Lifecycleprovisioningstatus = {
     Failed: 'FAILED'
 };
 /**
- * Detailed lifecycle request status stored on the lifecycle action request.
+ * Status of the lifecycle action request.
  * @export
  * @enum {string}
  */
@@ -151,8 +154,8 @@ var MachineIdentityLifecycleActionsApiAxiosParamCreator = function (configuratio
     var _this = this;
     return {
         /**
-         * Attempts to cancel a lifecycle request before provisioning starts.  The path `requestId` is authoritative for lookup and authorization. The request body is optional and may carry cancel metadata such as `comment`. Any `requestId` value in the body is ignored.  Workflow cancel signaling is attempted before the request is persisted as `CANCELING`. If signaling fails, the service returns **503** (`DOWNSTREAM_SERVICE_UNAVAILABLE`, cause `workflow-signal-failed`) and the lifecycle request status is unchanged.  Invalid cancel states are returned as **400** (`INVALID_REQUEST_IN_CURRENT_STATE` variants).  Cancel authorization matches https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1: the original submitter is always allowed; otherwise callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** target role-context access.  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context. - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`.  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType`/target-identity subtype   mismatch.
-         * @summary Cancel lifecycle action
+         * Cancels a lifecycle action request that hasn\'t started provisioning yet. When the cancel is accepted, the request moves to `CANCELING` status.  A request can\'t be canceled once provisioning has started, after it has finished, or while a cancel is already in progress.  The request body is optional. Use it to add a comment explaining why the request was canceled.  You can always cancel requests that you submitted. To cancel a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.  If the cancel can\'t be completed, the API returns an error and the request stays in `CANCELING` status.
+         * @summary Cancel machine identity lifecycle action
          * @param {string} requestId Lifecycle request identifier.
          * @param {string} [xSailPointExperimental] Use this header to enable this experimental API.
          * @param {CancelLifecycleActionRequest} [cancelLifecycleActionRequest]
@@ -194,8 +197,8 @@ var MachineIdentityLifecycleActionsApiAxiosParamCreator = function (configuratio
             });
         },
         /**
-         * Returns one lifecycle request snapshot by `requestId`. Used for request-level inspection, including cancel acceptance and subsequent status changes.  The original requester is always allowed to read their request. Otherwise, callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context (response includes `requestId` as a parameter). - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`   (`targetType` on read-by-request-id paths).  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType` does not match the   target machine identity\'s subtype-to-resource-type mapping.
-         * @summary Get lifecycle action by requestId
+         * Returns a single lifecycle action request, including its current status, approval details, and provisioning progress. Use it to follow a request after you submit or cancel it.  You can always view requests that you submitted. To view a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
+         * @summary Get machine identity lifecycle action
          * @param {string} requestId Lifecycle request identifier.
          * @param {string} [xSailPointExperimental] Use this header to enable this experimental API.
          * @param {*} [axiosOptions] Override http request option.
@@ -234,9 +237,9 @@ var MachineIdentityLifecycleActionsApiAxiosParamCreator = function (configuratio
             });
         },
         /**
-         * Lists lifecycle requests visible to the requester identity in the current request context.  Results are automatically scoped to the calling identity. If requester identity context is missing, an empty list is returned.  When `limit` is omitted, this endpoint applies a default limit of 50.
-         * @summary List lifecycle actions
-         * @param {string} [filters] Filter results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#filtering-results)  Filtering is supported for the following fields and operators:  **resourceType**: *eq, in*  **operationType**: *eq, in*  **status**: *eq, in*  **completed**: *eq*  **targetId**: *eq*  **targetName**: *eq, sw*  **sourceId**: *eq*  **created**: *gt, ge, lt, le*
+         * Returns the lifecycle action requests that you submitted. Requests that other users submitted aren\'t included, even if you\'re an admin. If the call isn\'t made on behalf of an identity, the list is empty.  When `limit` is omitted, up to 50 results are returned.
+         * @summary List machine identity lifecycle actions
+         * @param {string} [filters] Filter results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#filtering-results)  Filtering is supported for the following fields and operators:  **resourceType**: *eq, in*  **operationType**: *eq, in*  **status**: *eq, in*  **completed**: *eq*  **targetId**: *eq*  **targetName**: *eq, sw*  **sourceId**: *eq*  **created**: *gt, ge, lt, le*  The `resourceType` filter matches the `targetType` field in the response.
          * @param {string} [sorters] Sort results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **created, modified, status**  Default sort is **-created** (newest first).
          * @param {number} [limit] Max number of results to return. When omitted, the default limit is 50. The maximum allowed limit is 250.  See [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters) for more information.
          * @param {number} [offset] Offset into the full result set. Usually specified with *limit* to paginate through the results. See [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters) for more information.
@@ -290,7 +293,7 @@ var MachineIdentityLifecycleActionsApiAxiosParamCreator = function (configuratio
             });
         },
         /**
-         * Creates a lifecycle request for the target machine identity and returns the created lifecycle snapshot.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes the generated `requestId`, which is used by https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1, https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1, and https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1  Authorization is enforced in the service layer. Callers must have the `idn:machine-identity-lifecycle-action:manage` scope or role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  Supported actions are `DEACTIVATE`, `ACTIVATE`.
+         * Submits a request to activate or deactivate a machine identity. Supported actions are `ACTIVATE` and `DEACTIVATE`.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes a `requestId`. Use it to [get the request](https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1) or [cancel it](https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1). To see all the requests you\'ve submitted, use [list machine identity lifecycle actions](https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1).  Only one lifecycle action can be in progress for a machine identity at a time. If another action is already in progress for the machine identity, the request is rejected.  To submit a lifecycle action, you need the `idn:machine-identity:lifecycle-action` right, or admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
          * @summary Submit machine identity lifecycle action
          * @param {string} id Machine identity ID.
          * @param {LifecycleActionSubmitRequest} lifecycleActionSubmitRequest
@@ -345,8 +348,8 @@ var MachineIdentityLifecycleActionsApiFp = function (configuration) {
     var localVarAxiosParamCreator = (0, exports.MachineIdentityLifecycleActionsApiAxiosParamCreator)(configuration);
     return {
         /**
-         * Attempts to cancel a lifecycle request before provisioning starts.  The path `requestId` is authoritative for lookup and authorization. The request body is optional and may carry cancel metadata such as `comment`. Any `requestId` value in the body is ignored.  Workflow cancel signaling is attempted before the request is persisted as `CANCELING`. If signaling fails, the service returns **503** (`DOWNSTREAM_SERVICE_UNAVAILABLE`, cause `workflow-signal-failed`) and the lifecycle request status is unchanged.  Invalid cancel states are returned as **400** (`INVALID_REQUEST_IN_CURRENT_STATE` variants).  Cancel authorization matches https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1: the original submitter is always allowed; otherwise callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** target role-context access.  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context. - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`.  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType`/target-identity subtype   mismatch.
-         * @summary Cancel lifecycle action
+         * Cancels a lifecycle action request that hasn\'t started provisioning yet. When the cancel is accepted, the request moves to `CANCELING` status.  A request can\'t be canceled once provisioning has started, after it has finished, or while a cancel is already in progress.  The request body is optional. Use it to add a comment explaining why the request was canceled.  You can always cancel requests that you submitted. To cancel a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.  If the cancel can\'t be completed, the API returns an error and the request stays in `CANCELING` status.
+         * @summary Cancel machine identity lifecycle action
          * @param {string} requestId Lifecycle request identifier.
          * @param {string} [xSailPointExperimental] Use this header to enable this experimental API.
          * @param {CancelLifecycleActionRequest} [cancelLifecycleActionRequest]
@@ -370,8 +373,8 @@ var MachineIdentityLifecycleActionsApiFp = function (configuration) {
             });
         },
         /**
-         * Returns one lifecycle request snapshot by `requestId`. Used for request-level inspection, including cancel acceptance and subsequent status changes.  The original requester is always allowed to read their request. Otherwise, callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context (response includes `requestId` as a parameter). - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`   (`targetType` on read-by-request-id paths).  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType` does not match the   target machine identity\'s subtype-to-resource-type mapping.
-         * @summary Get lifecycle action by requestId
+         * Returns a single lifecycle action request, including its current status, approval details, and provisioning progress. Use it to follow a request after you submit or cancel it.  You can always view requests that you submitted. To view a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
+         * @summary Get machine identity lifecycle action
          * @param {string} requestId Lifecycle request identifier.
          * @param {string} [xSailPointExperimental] Use this header to enable this experimental API.
          * @param {*} [axiosOptions] Override http request option.
@@ -394,9 +397,9 @@ var MachineIdentityLifecycleActionsApiFp = function (configuration) {
             });
         },
         /**
-         * Lists lifecycle requests visible to the requester identity in the current request context.  Results are automatically scoped to the calling identity. If requester identity context is missing, an empty list is returned.  When `limit` is omitted, this endpoint applies a default limit of 50.
-         * @summary List lifecycle actions
-         * @param {string} [filters] Filter results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#filtering-results)  Filtering is supported for the following fields and operators:  **resourceType**: *eq, in*  **operationType**: *eq, in*  **status**: *eq, in*  **completed**: *eq*  **targetId**: *eq*  **targetName**: *eq, sw*  **sourceId**: *eq*  **created**: *gt, ge, lt, le*
+         * Returns the lifecycle action requests that you submitted. Requests that other users submitted aren\'t included, even if you\'re an admin. If the call isn\'t made on behalf of an identity, the list is empty.  When `limit` is omitted, up to 50 results are returned.
+         * @summary List machine identity lifecycle actions
+         * @param {string} [filters] Filter results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#filtering-results)  Filtering is supported for the following fields and operators:  **resourceType**: *eq, in*  **operationType**: *eq, in*  **status**: *eq, in*  **completed**: *eq*  **targetId**: *eq*  **targetName**: *eq, sw*  **sourceId**: *eq*  **created**: *gt, ge, lt, le*  The `resourceType` filter matches the `targetType` field in the response.
          * @param {string} [sorters] Sort results using the standard syntax described in [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **created, modified, status**  Default sort is **-created** (newest first).
          * @param {number} [limit] Max number of results to return. When omitted, the default limit is 50. The maximum allowed limit is 250.  See [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters) for more information.
          * @param {number} [offset] Offset into the full result set. Usually specified with *limit* to paginate through the results. See [API Standard Collection Parameters](https://developer.sailpoint.com/docs/api/standard-collection-parameters) for more information.
@@ -422,7 +425,7 @@ var MachineIdentityLifecycleActionsApiFp = function (configuration) {
             });
         },
         /**
-         * Creates a lifecycle request for the target machine identity and returns the created lifecycle snapshot.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes the generated `requestId`, which is used by https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1, https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1, and https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1  Authorization is enforced in the service layer. Callers must have the `idn:machine-identity-lifecycle-action:manage` scope or role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  Supported actions are `DEACTIVATE`, `ACTIVATE`.
+         * Submits a request to activate or deactivate a machine identity. Supported actions are `ACTIVATE` and `DEACTIVATE`.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes a `requestId`. Use it to [get the request](https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1) or [cancel it](https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1). To see all the requests you\'ve submitted, use [list machine identity lifecycle actions](https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1).  Only one lifecycle action can be in progress for a machine identity at a time. If another action is already in progress for the machine identity, the request is rejected.  To submit a lifecycle action, you need the `idn:machine-identity:lifecycle-action` right, or admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
          * @summary Submit machine identity lifecycle action
          * @param {string} id Machine identity ID.
          * @param {LifecycleActionSubmitRequest} lifecycleActionSubmitRequest
@@ -457,8 +460,8 @@ var MachineIdentityLifecycleActionsApiFactory = function (configuration, basePat
     var localVarFp = (0, exports.MachineIdentityLifecycleActionsApiFp)(configuration);
     return {
         /**
-         * Attempts to cancel a lifecycle request before provisioning starts.  The path `requestId` is authoritative for lookup and authorization. The request body is optional and may carry cancel metadata such as `comment`. Any `requestId` value in the body is ignored.  Workflow cancel signaling is attempted before the request is persisted as `CANCELING`. If signaling fails, the service returns **503** (`DOWNSTREAM_SERVICE_UNAVAILABLE`, cause `workflow-signal-failed`) and the lifecycle request status is unchanged.  Invalid cancel states are returned as **400** (`INVALID_REQUEST_IN_CURRENT_STATE` variants).  Cancel authorization matches https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1: the original submitter is always allowed; otherwise callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** target role-context access.  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context. - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`.  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType`/target-identity subtype   mismatch.
-         * @summary Cancel lifecycle action
+         * Cancels a lifecycle action request that hasn\'t started provisioning yet. When the cancel is accepted, the request moves to `CANCELING` status.  A request can\'t be canceled once provisioning has started, after it has finished, or while a cancel is already in progress.  The request body is optional. Use it to add a comment explaining why the request was canceled.  You can always cancel requests that you submitted. To cancel a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.  If the cancel can\'t be completed, the API returns an error and the request stays in `CANCELING` status.
+         * @summary Cancel machine identity lifecycle action
          * @param {MachineIdentityLifecycleActionsApiCancelMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
          * @param {*} [axiosOptions] Override http request option.
          * @throws {RequiredError}
@@ -467,8 +470,8 @@ var MachineIdentityLifecycleActionsApiFactory = function (configuration, basePat
             return localVarFp.cancelMachineIdentityLifecycleActionV1(requestParameters.requestId, requestParameters.xSailPointExperimental, requestParameters.cancelLifecycleActionRequest, axiosOptions).then(function (request) { return request(axios, basePath); });
         },
         /**
-         * Returns one lifecycle request snapshot by `requestId`. Used for request-level inspection, including cancel acceptance and subsequent status changes.  The original requester is always allowed to read their request. Otherwise, callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context (response includes `requestId` as a parameter). - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`   (`targetType` on read-by-request-id paths).  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType` does not match the   target machine identity\'s subtype-to-resource-type mapping.
-         * @summary Get lifecycle action by requestId
+         * Returns a single lifecycle action request, including its current status, approval details, and provisioning progress. Use it to follow a request after you submit or cancel it.  You can always view requests that you submitted. To view a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
+         * @summary Get machine identity lifecycle action
          * @param {MachineIdentityLifecycleActionsApiGetMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
          * @param {*} [axiosOptions] Override http request option.
          * @throws {RequiredError}
@@ -477,8 +480,8 @@ var MachineIdentityLifecycleActionsApiFactory = function (configuration, basePat
             return localVarFp.getMachineIdentityLifecycleActionV1(requestParameters.requestId, requestParameters.xSailPointExperimental, axiosOptions).then(function (request) { return request(axios, basePath); });
         },
         /**
-         * Lists lifecycle requests visible to the requester identity in the current request context.  Results are automatically scoped to the calling identity. If requester identity context is missing, an empty list is returned.  When `limit` is omitted, this endpoint applies a default limit of 50.
-         * @summary List lifecycle actions
+         * Returns the lifecycle action requests that you submitted. Requests that other users submitted aren\'t included, even if you\'re an admin. If the call isn\'t made on behalf of an identity, the list is empty.  When `limit` is omitted, up to 50 results are returned.
+         * @summary List machine identity lifecycle actions
          * @param {MachineIdentityLifecycleActionsApiListMachineIdentityLifecycleActionsV1Request} requestParameters Request parameters.
          * @param {*} [axiosOptions] Override http request option.
          * @throws {RequiredError}
@@ -488,7 +491,7 @@ var MachineIdentityLifecycleActionsApiFactory = function (configuration, basePat
             return localVarFp.listMachineIdentityLifecycleActionsV1(requestParameters.filters, requestParameters.sorters, requestParameters.limit, requestParameters.offset, requestParameters.count, requestParameters.xSailPointExperimental, axiosOptions).then(function (request) { return request(axios, basePath); });
         },
         /**
-         * Creates a lifecycle request for the target machine identity and returns the created lifecycle snapshot.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes the generated `requestId`, which is used by https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1, https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1, and https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1  Authorization is enforced in the service layer. Callers must have the `idn:machine-identity-lifecycle-action:manage` scope or role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  Supported actions are `DEACTIVATE`, `ACTIVATE`.
+         * Submits a request to activate or deactivate a machine identity. Supported actions are `ACTIVATE` and `DEACTIVATE`.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes a `requestId`. Use it to [get the request](https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1) or [cancel it](https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1). To see all the requests you\'ve submitted, use [list machine identity lifecycle actions](https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1).  Only one lifecycle action can be in progress for a machine identity at a time. If another action is already in progress for the machine identity, the request is rejected.  To submit a lifecycle action, you need the `idn:machine-identity:lifecycle-action` right, or admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
          * @summary Submit machine identity lifecycle action
          * @param {MachineIdentityLifecycleActionsApiSubmitMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
          * @param {*} [axiosOptions] Override http request option.
@@ -512,8 +515,8 @@ var MachineIdentityLifecycleActionsApi = /** @class */ (function (_super) {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     /**
-     * Attempts to cancel a lifecycle request before provisioning starts.  The path `requestId` is authoritative for lookup and authorization. The request body is optional and may carry cancel metadata such as `comment`. Any `requestId` value in the body is ignored.  Workflow cancel signaling is attempted before the request is persisted as `CANCELING`. If signaling fails, the service returns **503** (`DOWNSTREAM_SERVICE_UNAVAILABLE`, cause `workflow-signal-failed`) and the lifecycle request status is unchanged.  Invalid cancel states are returned as **400** (`INVALID_REQUEST_IN_CURRENT_STATE` variants).  Cancel authorization matches https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1: the original submitter is always allowed; otherwise callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** target role-context access.  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context. - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`.  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType`/target-identity subtype   mismatch.
-     * @summary Cancel lifecycle action
+     * Cancels a lifecycle action request that hasn\'t started provisioning yet. When the cancel is accepted, the request moves to `CANCELING` status.  A request can\'t be canceled once provisioning has started, after it has finished, or while a cancel is already in progress.  The request body is optional. Use it to add a comment explaining why the request was canceled.  You can always cancel requests that you submitted. To cancel a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.  If the cancel can\'t be completed, the API returns an error and the request stays in `CANCELING` status.
+     * @summary Cancel machine identity lifecycle action
      * @param {MachineIdentityLifecycleActionsApiCancelMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
      * @param {*} [axiosOptions] Override http request option.
      * @throws {RequiredError}
@@ -524,8 +527,8 @@ var MachineIdentityLifecycleActionsApi = /** @class */ (function (_super) {
         return (0, exports.MachineIdentityLifecycleActionsApiFp)(this.configuration).cancelMachineIdentityLifecycleActionV1(requestParameters.requestId, requestParameters.xSailPointExperimental, requestParameters.cancelLifecycleActionRequest, axiosOptions).then(function (request) { return request(_this.axios, _this.basePath); });
     };
     /**
-     * Returns one lifecycle request snapshot by `requestId`. Used for request-level inspection, including cancel acceptance and subsequent status changes.  The original requester is always allowed to read their request. Otherwise, callers must have the `idn:machine-identity-lifecycle-action:manage` scope **and** role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  **403 Forbidden**  - `FORBIDDEN.lifecycle-request-access-denied` - caller is not the submitter and lacks both the   `idn:machine-identity-lifecycle-action:manage` scope and target role-context (response includes `requestId` as a parameter). - `FORBIDDEN.unsupported-type` - the persisted lifecycle row is not scoped to `AI_AGENT`   (`targetType` on read-by-request-id paths).  **404 Not Found**  - `NOT_FOUND.detailed` - unknown `requestId`, or persisted `targetType` does not match the   target machine identity\'s subtype-to-resource-type mapping.
-     * @summary Get lifecycle action by requestId
+     * Returns a single lifecycle action request, including its current status, approval details, and provisioning progress. Use it to follow a request after you submit or cancel it.  You can always view requests that you submitted. To view a request that someone else submitted, you need the `idn:machine-identity:lifecycle-action` right **and** admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
+     * @summary Get machine identity lifecycle action
      * @param {MachineIdentityLifecycleActionsApiGetMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
      * @param {*} [axiosOptions] Override http request option.
      * @throws {RequiredError}
@@ -536,8 +539,8 @@ var MachineIdentityLifecycleActionsApi = /** @class */ (function (_super) {
         return (0, exports.MachineIdentityLifecycleActionsApiFp)(this.configuration).getMachineIdentityLifecycleActionV1(requestParameters.requestId, requestParameters.xSailPointExperimental, axiosOptions).then(function (request) { return request(_this.axios, _this.basePath); });
     };
     /**
-     * Lists lifecycle requests visible to the requester identity in the current request context.  Results are automatically scoped to the calling identity. If requester identity context is missing, an empty list is returned.  When `limit` is omitted, this endpoint applies a default limit of 50.
-     * @summary List lifecycle actions
+     * Returns the lifecycle action requests that you submitted. Requests that other users submitted aren\'t included, even if you\'re an admin. If the call isn\'t made on behalf of an identity, the list is empty.  When `limit` is omitted, up to 50 results are returned.
+     * @summary List machine identity lifecycle actions
      * @param {MachineIdentityLifecycleActionsApiListMachineIdentityLifecycleActionsV1Request} requestParameters Request parameters.
      * @param {*} [axiosOptions] Override http request option.
      * @throws {RequiredError}
@@ -549,7 +552,7 @@ var MachineIdentityLifecycleActionsApi = /** @class */ (function (_super) {
         return (0, exports.MachineIdentityLifecycleActionsApiFp)(this.configuration).listMachineIdentityLifecycleActionsV1(requestParameters.filters, requestParameters.sorters, requestParameters.limit, requestParameters.offset, requestParameters.count, requestParameters.xSailPointExperimental, axiosOptions).then(function (request) { return request(_this.axios, _this.basePath); });
     };
     /**
-     * Creates a lifecycle request for the target machine identity and returns the created lifecycle snapshot.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes the generated `requestId`, which is used by https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1, https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1, and https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1  Authorization is enforced in the service layer. Callers must have the `idn:machine-identity-lifecycle-action:manage` scope or role-context access to the target machine identity (organization admin, source admin, scoped source sub-admin, or effective owner).  Supported actions are `DEACTIVATE`, `ACTIVATE`.
+     * Submits a request to activate or deactivate a machine identity. Supported actions are `ACTIVATE` and `DEACTIVATE`.  **Note:** Lifecycle actions are currently supported only for machine identities of type **Agent**.  The response includes a `requestId`. Use it to [get the request](https://developer.sailpoint.com/docs/api/get-machine-identity-lifecycle-action-v-1) or [cancel it](https://developer.sailpoint.com/docs/api/cancel-machine-identity-lifecycle-action-v-1). To see all the requests you\'ve submitted, use [list machine identity lifecycle actions](https://developer.sailpoint.com/docs/api/list-machine-identity-lifecycle-actions-v-1).  Only one lifecycle action can be in progress for a machine identity at a time. If another action is already in progress for the machine identity, the request is rejected.  To submit a lifecycle action, you need the `idn:machine-identity:lifecycle-action` right, or admin or owner access to the machine identity. Admin or owner access means you\'re an org admin, a source admin, a source sub-admin for the machine identity\'s source, or the machine identity\'s owner.
      * @summary Submit machine identity lifecycle action
      * @param {MachineIdentityLifecycleActionsApiSubmitMachineIdentityLifecycleActionV1Request} requestParameters Request parameters.
      * @param {*} [axiosOptions] Override http request option.