List machine accounts
GET/machine-accounts/v2
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.
Use this API to get a list of machine accounts. By default, the list includes machine accounts that are linked to a machine identity or to a source resource.
When the whole filter is a single comparison on machineIdentity.id or machineIdentity.name, the list also includes machine accounts linked to the matching machine identities through source resource links.
A caller without the idn:mis-account-list:read right can call this API only when every returned machine account is one they own; otherwise this API returns 403. Use ownerIdentity=self to list only the caller's own machine accounts.
When this capability is not enabled for the tenant, this API returns 403.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
List of machine accounts.
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.