Submit machine identity lifecycle action
POST/machine-identities/v1/:id/lifecycle-actions
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.
Creates a lifecycle request for the target machine identity and returns the created lifecycle snapshot.
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.
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 429
- 500
Accepted. The lifecycle request was created.
Client Error - Returned if the request body is invalid.
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Not Found - returned if the request URL refers to a resource or object that does not exist
Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Internal Server Error - Returned if there is an unexpected error.