Skip to main content

ClassifySource

All URIs are relative to https://sailpoint.api.identitynow.com/v2025

MethodHTTP requestDescription
Remove-V2025ClassifyMachineAccountFromSourceDELETE /sources/{sourceId}/classifyCancel classify source's accounts process
Get-V2025ClassifyMachineAccountFromSourceStatusGET /sources/{sourceId}/classifySource accounts classification status
Send-V2025ClassifyMachineAccountFromSourcePOST /sources/{sourceId}/classifyClassify source's all accounts

delete-classify-machine-account-from-source

Use this API to cancel account classification process on a source. A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

Param TypeNameData TypeRequiredDescription
PathIdStringTrueSource ID.

Return type

(empty response body)

Responses

CodeDescriptionData Type
204No content - indicates the request was successful but there is no content to be returned in the response.
400Client Error - Returned if the request body is invalid.ErrorResponseDto
401Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.ListAccessProfiles401Response
403Forbidden - Returned if the user you are running as, doesn't have access to this end-point.ErrorResponseDto
429Too 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.ListAccessProfiles429Response
500Internal Server Error - Returned if there is an unexpected error.ErrorResponseDto

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

$Id = "ef38f94347e94562b5bb8424a56397d8" # String | Source ID.

# Cancel classify source's accounts process

try {
Remove-V2025ClassifyMachineAccountFromSource -Id $Id

# Below is a request that includes all optional parameters
# Remove-V2025ClassifyMachineAccountFromSource -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2025ClassifyMachineAccountFromSource"
Write-Host $_.ErrorDetails
}

[Back to top]

get-classify-machine-account-from-source-status

Use this API to get the status of Machine Account Classification process for a source. A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

Param TypeNameData TypeRequiredDescription
PathIdStringTrueSource ID.

Return type

SourceClassificationStatus

Responses

CodeDescriptionData Type
200Source Accounts Classification Status object.SourceClassificationStatus
400Client Error - Returned if the request body is invalid.ErrorResponseDto
401Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.ListAccessProfiles401Response
403Forbidden - Returned if the user you are running as, doesn't have access to this end-point.ErrorResponseDto
404Not Found - returned if the request URL refers to a resource or object that does not existErrorResponseDto
429Too 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.ListAccessProfiles429Response
500Internal Server Error - Returned if there is an unexpected error.ErrorResponseDto

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

$Id = "ef38f94347e94562b5bb8424a56397d8" # String | Source ID.

# Source accounts classification status

try {
Get-V2025ClassifyMachineAccountFromSourceStatus -Id $Id

# Below is a request that includes all optional parameters
# Get-V2025ClassifyMachineAccountFromSourceStatus -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2025ClassifyMachineAccountFromSourceStatus"
Write-Host $_.ErrorDetails
}

[Back to top]

send-classify-machine-account-from-source

Use this API to classify all the accounts from a source. A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

Param TypeNameData TypeRequiredDescription
PathIdStringTrueSource ID.

Return type

SendClassifyMachineAccountFromSource200Response

Responses

CodeDescriptionData Type
200Source's all accounts submitted for classification.SendClassifyMachineAccountFromSource200Response
400Client Error - Returned if the request body is invalid.ErrorResponseDto
401Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.ListAccessProfiles401Response
403Forbidden - Returned if the user you are running as, doesn't have access to this end-point.ErrorResponseDto
429Too 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.ListAccessProfiles429Response
500Internal Server Error - Returned if there is an unexpected error.ErrorResponseDto

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

$Id = "ef38f94347e94562b5bb8424a56397d8" # String | Source ID.

# Classify source's all accounts

try {
Send-V2025ClassifyMachineAccountFromSource -Id $Id

# Below is a request that includes all optional parameters
# Send-V2025ClassifyMachineAccountFromSource -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Send-V2025ClassifyMachineAccountFromSource"
Write-Host $_.ErrorDetails
}

[Back to top]