Skip to main content

ClassifySource

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

MethodHTTP requestDescription
Remove-ClassifyMachineAccountFromSourceV1DELETE /sources/v1/{sourceId}/classifyCancel classify source's accounts process
Get-ClassifyMachineAccountFromSourceStatusV1GET /sources/v1/{sourceId}/classifySource accounts classification status
Send-ClassifyMachineAccountFromSourceV1POST /sources/v1/{sourceId}/classifyClassify source's all accounts

delete-classify-machine-account-from-source-v1

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
PathSourceIdStringTrueSource 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.GetClassifyMachineAccountFromSourceStatusV1401Response
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.GetClassifyMachineAccountFromSourceStatusV1429Response
500Internal Server Error - Returned if there is an unexpected error.Errorresponsedto

HTTP request headers

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

Example

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

# Cancel classify source's accounts process

try {
Remove-ClassifyMachineAccountFromSourceV1 -SourceId $SourceId

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

[Back to top]

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

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
PathSourceIdStringTrueSource 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.GetClassifyMachineAccountFromSourceStatusV1401Response
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.GetClassifyMachineAccountFromSourceStatusV1429Response
500Internal Server Error - Returned if there is an unexpected error.Errorresponsedto

HTTP request headers

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

Example

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

# Source accounts classification status

try {
Get-ClassifyMachineAccountFromSourceStatusV1 -SourceId $SourceId

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

[Back to top]

send-classify-machine-account-from-source-v1

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
PathSourceIdStringTrueSource ID.

Return type

SendClassifyMachineAccountFromSourceV1200Response

Responses

CodeDescriptionData Type
200Source's all accounts submitted for classification.SendClassifyMachineAccountFromSourceV1200Response
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.GetClassifyMachineAccountFromSourceStatusV1401Response
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.GetClassifyMachineAccountFromSourceStatusV1429Response
500Internal Server Error - Returned if there is an unexpected error.Errorresponsedto

HTTP request headers

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

Example

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

# Classify source's all accounts

try {
Send-ClassifyMachineAccountFromSourceV1 -SourceId $SourceId

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

[Back to top]