Skip to main content

MachineAccountClassify

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

MethodHTTP requestDescription
Send-V2024ClassifyMachineAccountPOST /accounts/{id}/classifyClassify a Single Machine Account

send-classify-machine-account

Use this API to classify a single machine account. A token with API, ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

Param TypeNameData TypeRequiredDescription
PathIdStringTrueAccount ID.
QueryClassificationModeString(optional) (default to "default")Specifies how the accounts should be classified. default - uses criteria to classify account as machine or human, excludes accounts that were manually classified. ignoreManual - like default, but includes accounts that were manually classified. forceMachine - forces account to be classified as machine. forceHuman - forces account to be classified as human.

Return type

SendClassifyMachineAccount200Response

Responses

CodeDescriptionData Type
200Account classified as Machine.SendClassifyMachineAccount200Response
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 | Account ID.
$ClassificationMode = "default" # String | Specifies how the accounts should be classified. default - uses criteria to classify account as machine or human, excludes accounts that were manually classified. ignoreManual - like default, but includes accounts that were manually classified. forceMachine - forces account to be classified as machine. forceHuman - forces account to be classified as human. (optional) (default to "default")

# Classify a Single Machine Account

try {
Send-V2024ClassifyMachineAccount -Id $Id

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

[Back to top]