List subtypes
GET/source-subtypes/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.
List machine account subtypes defined at the source tier and the connector tier.
Without sourceId, the API lists every subtype in the tenant, and filters and sorters apply.
With sourceId, the API returns the source's effective subtypes: the subtypes defined for the source plus the
subtypes defined for the source's connector type. When a source subtype has the same technical name as a connector
subtype, only the source subtype is returned and its origin is CONNECTOR. filters cannot be used in this mode.
Use targetType to return only one tier of the effective set. An unknown sourceId returns 404.
With sourceId and effectiveSet=false, the API returns only the subtypes defined for that source, and filters
apply.
The caller needs the idn:source-subtypes:read right.
This API returns 404 when Machine Identity Security or tiered subtype configuration is not enabled for the tenant.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
List of machine account subtypes. Items include config when includeConfigs=true. The X-Total-Count header is returned when count=true.
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.