Delete ai agent asynchronously
DELETE/machine-identities/v1/:id/delete-async
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.
This API deletes an AI agent machine identity. It applies only to AI agents. Application machine identities return
400; delete them with the delete machine identity API instead.
When the AI agent was aggregated from a source and still exists on that source, the API starts a deletion task on
the source and returns the task status. When the AI agent was created manually or no longer exists on the source,
the API deletes it immediately and returns 200 with an empty body.
The API returns 400 when the AI agent is still assigned to machine accounts, or when its source does not support
deleting it. It returns 404 when the machine identity or its source is not found.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Status of the deletion task. The body is empty when the AI agent was deleted immediately.
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.