Delete tiered subtype by id
DELETE/source-subtypes/v2/:id
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.
Deletes a tiered subtype by id.
System-managed subtypes return 400. A subtype that is still assigned to accounts returns 400. A connector-tier response includes how many accounts and sources still use it.
SOURCE-tier delete requires idn:source-subtypes:delete. CONNECTOR-tier delete requires
idn:connector-subtypes:delete. Unknown id and a denied tier are both returned as 404. A
malformed UUID returns 400.
When the experimental header is missing, or when the tiered subtype configuration is not enabled for the tenant, the endpoint returns 404.
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 429
- 500
No content - indicates the request was successful but there is no content to be returned in the response.
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.