Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$Id="MyId"# String | Non-Employee approval item id (UUID)$NonEmployeeApprovalDecision=@"{
"comment" : "comment"
}"@# Approve a Non-Employee Requesttry{$Result=ConvertFrom-JsonToNonEmployeeApprovalDecision-Json$NonEmployeeApprovalDecisionApprove-BetaNonEmployeeRequest-BetaId$Id-BetaNonEmployeeApprovalDecision$Result# Below is a request that includes all optional parameters# Approve-BetaNonEmployeeRequest -BetaId $Id -BetaNonEmployeeApprovalDecision $NonEmployeeApprovalDecision }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Approve-BetaNonEmployeeRequest"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$NonEmployeeRequestBody=@"{
"sourceId" : "2c91808568c529c60168cca6f90c1313",
"firstName" : "William",
"lastName" : "Smith",
"manager" : "jane.doe",
"data" : {
"description" : "Auditing"
},
"accountName" : "william.smith",
"phone" : "5125555555",
"endDate" : "2021-03-25T00:00:00-05:00",
"email" : "william.smith@example.com",
"startDate" : "2020-03-24T00:00:00-05:00"
}"@# Create Non-Employee Recordtry{$Result=ConvertFrom-JsonToNonEmployeeRequestBody-Json$NonEmployeeRequestBodyNew-BetaNonEmployeeRecord-BetaNonEmployeeRequestBody$Result# Below is a request that includes all optional parameters# New-BetaNonEmployeeRecord -BetaNonEmployeeRequestBody $NonEmployeeRequestBody }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling New-BetaNonEmployeeRecord"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$NonEmployeeRequestBody=@"{
"sourceId" : "2c91808568c529c60168cca6f90c1313",
"firstName" : "William",
"lastName" : "Smith",
"manager" : "jane.doe",
"data" : {
"description" : "Auditing"
},
"accountName" : "william.smith",
"phone" : "5125555555",
"endDate" : "2021-03-25T00:00:00-05:00",
"email" : "william.smith@example.com",
"startDate" : "2020-03-24T00:00:00-05:00"
}"@# Create Non-Employee Requesttry{$Result=ConvertFrom-JsonToNonEmployeeRequestBody-Json$NonEmployeeRequestBodyNew-BetaNonEmployeeRequest-BetaNonEmployeeRequestBody$Result# Below is a request that includes all optional parameters# New-BetaNonEmployeeRequest -BetaNonEmployeeRequestBody $NonEmployeeRequestBody }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling New-BetaNonEmployeeRequest"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
This API creates a new schema attribute for Non-Employee Source. The schema technical name must be unique in the source. Attempts to create a schema attribute with an existing name will result in a "400.1.409 Reference conflict" response. At most, 10 custom attributes can be created per schema. Attempts to create more than 10 will result in a "400.1.4 Limit violation" response.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | The Source id$NonEmployeeSchemaAttributeBody=@"{
"helpText" : "Theuniqueidentifierfortheaccount",
"label" : "AccountName",
"placeholder" : "Enterauniqueusernameforthisaccount.",
"type" : "TEXT",
"technicalName" : "account.name",
"required" : true
}"@# Create Non-Employee Source Schema Attributetry{$Result=ConvertFrom-JsonToNonEmployeeSchemaAttributeBody-Json$NonEmployeeSchemaAttributeBodyNew-BetaNonEmployeeSourceSchemaAttributes-BetaSourceId$SourceId-BetaNonEmployeeSchemaAttributeBody$Result# Below is a request that includes all optional parameters# New-BetaNonEmployeeSourceSchemaAttributes -BetaSourceId $SourceId -BetaNonEmployeeSchemaAttributeBody $NonEmployeeSchemaAttributeBody }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling New-BetaNonEmployeeSourceSchemaAttributes"Write-Host$_.ErrorDetails}
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-Employee record id (UUID)# Delete Non-Employee Recordtry{Remove-BetaNonEmployeeRecord-BetaId$Id# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeRecord -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeRecord"Write-Host$_.ErrorDetails}
This request will delete multiple non-employee records based on the non-employee ids provided.
Request will require the following scope:
'idn:nesr:delete'
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$DeleteNonEmployeeRecordInBulkRequest=@""@# Delete Multiple Non-Employee Recordstry{$Result=ConvertFrom-JsonToDeleteNonEmployeeRecordInBulkRequest-Json$DeleteNonEmployeeRecordInBulkRequestRemove-BetaNonEmployeeRecordInBulk-BetaDeleteNonEmployeeRecordInBulkRequest$Result# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeRecordInBulk -BetaDeleteNonEmployeeRecordInBulkRequest $DeleteNonEmployeeRecordInBulkRequest }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeRecordInBulk"Write-Host$_.ErrorDetails}
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-Employee request id in the UUID format# Delete Non-Employee Requesttry{Remove-BetaNonEmployeeRequest-BetaId$Id# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeRequest -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeRequest"Write-Host$_.ErrorDetails}
This end-point deletes a specific schema attribute for a non-employee source.
Parameters
Param Type
Name
Data Type
Required
Description
Path
AttributeId
String
True
The Schema Attribute Id (UUID)
Path
SourceId
String
True
The Source id
Return type
(empty response body)
Responses
Code
Description
Data Type
204
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$AttributeId="2c91808b6ef1d43e016efba0ce470904"# String | The Schema Attribute Id (UUID)$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | The Source id# Delete Non-Employee Source's Schema Attributetry{Remove-BetaNonEmployeeSchemaAttribute-BetaAttributeId$AttributeId-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeSchemaAttribute -BetaAttributeId $AttributeId -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeSchemaAttribute"Write-Host$_.ErrorDetails}
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | Source Id# Delete Non-Employee Sourcetry{Remove-BetaNonEmployeeSource-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeSource -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeSource"Write-Host$_.ErrorDetails}
This end-point deletes all custom schema attributes for a non-employee source.
Parameters
Param Type
Name
Data Type
Required
Description
Path
SourceId
String
True
The Source id
Return type
(empty response body)
Responses
Code
Description
Data Type
204
No content - indicates the request was successful but there is no content to be returned in the response.
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | The Source id# Delete all custom schema attributestry{Remove-BetaNonEmployeeSourceSchemaAttributes-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Remove-BetaNonEmployeeSourceSchemaAttributes -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Remove-BetaNonEmployeeSourceSchemaAttributes"Write-Host$_.ErrorDetails}
This requests a CSV download for all non-employees from a provided source.
Parameters
Param Type
Name
Data Type
Required
Description
Path
Id
String
True
Source Id (UUID)
Return type
(empty response body)
Responses
Code
Description
Data Type
200
Exported CSV
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: text/csv, application/json
Example
$Id="2c918085842e69ae018432d22ccb212f"# String | Source Id (UUID)# Exports Non-Employee Records to CSVtry{Export-BetaNonEmployeeRecords-BetaId$Id# Below is a request that includes all optional parameters# Export-BetaNonEmployeeRecords -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Export-BetaNonEmployeeRecords"Write-Host$_.ErrorDetails}
This requests a download for the Source Schema Template for a provided source.
Request will require the following security scope:
idn:nesr:read'
Parameters
Param Type
Name
Data Type
Required
Description
Path
Id
String
True
Source Id (UUID)
Return type
(empty response body)
Responses
Code
Description
Data Type
200
Exported Source Schema Template
400
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: text/csv, application/json
Example
$Id="2c918085842e69ae018432d22ccb212f"# String | Source Id (UUID)# Exports Source Schema Templatetry{Export-BetaNonEmployeeSourceSchemaTemplate-BetaId$Id# Below is a request that includes all optional parameters# Export-BetaNonEmployeeSourceSchemaTemplate -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Export-BetaNonEmployeeSourceSchemaTemplate"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="ac10d20a-841e-1e7d-8184-32d2e22c0179"# String | Non-Employee approval item id (UUID)$IncludeDetail="include-detail=false"# String | The object nonEmployeeRequest will not be included detail when set to false. *Default value is true* (optional)# Get a non-employee approval item detailtry{Get-BetaNonEmployeeApproval-BetaId$Id# Below is a request that includes all optional parameters# Get-BetaNonEmployeeApproval -BetaId $Id -BetaIncludeDetail $IncludeDetail }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeApproval"Write-Host$_.ErrorDetails}
This request will retrieve a summary of non-employee approval requests. There are two contextual uses for the requested-for path parameter: 1. The current user is the Org Admin, in which case he or she may request a summary of all non-employee approval requests assigned to a particular approver by passing in that approver's id. 2. The current user is an approver, in which case "me" should be provided as the requested-for value. This will provide the approver with a summary of the approval items assigned to him or her.
Parameters
Param Type
Name
Data Type
Required
Description
Path
RequestedFor
String
True
The identity (UUID) of the approver for whom for whom the summary is being retrieved. Use ""me"" instead to indicate the current user.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$RequestedFor="ac10d20a-841e-1e7d-8184-32d2e22c0179"# String | The identity (UUID) of the approver for whom for whom the summary is being retrieved. Use ""me"" instead to indicate the current user.# Get Summary of Non-Employee Approval Requeststry{Get-BetaNonEmployeeApprovalSummary-BetaRequestedFor$RequestedFor# Below is a request that includes all optional parameters# Get-BetaNonEmployeeApprovalSummary -BetaRequestedFor $RequestedFor }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeApprovalSummary"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="2c918085842e69ae018432d22ccb212f"# String | Source ID (UUID)# Bulk upload status on sourcetry{Get-BetaNonEmployeeBulkUploadStatus-BetaId$Id# Below is a request that includes all optional parameters# Get-BetaNonEmployeeBulkUploadStatus -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeBulkUploadStatus"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-Employee record id (UUID)# Get a Non-Employee Recordtry{Get-BetaNonEmployeeRecord-BetaId$Id# Below is a request that includes all optional parameters# Get-BetaNonEmployeeRecord -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeRecord"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-Employee request id (UUID)# Get a Non-Employee Requesttry{Get-BetaNonEmployeeRequest-BetaId$Id# Below is a request that includes all optional parameters# Get-BetaNonEmployeeRequest -BetaId $Id }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeRequest"Write-Host$_.ErrorDetails}
This request will retrieve a summary of non-employee requests. There are two contextual uses for the requested-for path parameter: 1. The current user is the Org Admin, in which case he or she may request a summary of all non-employee approval requests assigned to a particular account manager by passing in that manager's id. 2. The current user is an account manager, in which case "me" should be provided as the requested-for value. This will provide the user with a summary of the non-employee requests in the source(s) he or she manages.
Parameters
Param Type
Name
Data Type
Required
Description
Path
RequestedFor
String
True
The identity (UUID) of the non-employee account manager for whom the summary is being retrieved. Use ""me"" instead to indicate the current user.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$RequestedFor="ac10d20a-841e-1e7d-8184-32d2e22c0179"# String | The identity (UUID) of the non-employee account manager for whom the summary is being retrieved. Use ""me"" instead to indicate the current user.# Get Summary of Non-Employee Requeststry{Get-BetaNonEmployeeRequestSummary-BetaRequestedFor$RequestedFor# Below is a request that includes all optional parameters# Get-BetaNonEmployeeRequestSummary -BetaRequestedFor $RequestedFor }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeRequestSummary"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$AttributeId="2c918085842e69ae018432d22ccb212f"# String | The Schema Attribute Id (UUID)$SourceId="2c918085842e69ae018432d22ccb212f"# String | The Source id# Get Schema Attribute Non-Employee Sourcetry{Get-BetaNonEmployeeSchemaAttribute-BetaAttributeId$AttributeId-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Get-BetaNonEmployeeSchemaAttribute -BetaAttributeId $AttributeId -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeSchemaAttribute"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$SourceId="2c91808b7c28b350017c2a2ec5790aa1"# String | Source Id# Get a Non-Employee Sourcetry{Get-BetaNonEmployeeSource-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Get-BetaNonEmployeeSource -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeSource"Write-Host$_.ErrorDetails}
This API gets the list of schema attributes for the specified Non-Employee SourceId. There are 8 mandatory attributes added to each new Non-Employee Source automatically. Additionaly, user can add up to 10 custom attributes. This interface returns all the mandatory attributes followed by any custom attributes. At most, a total of 18 attributes will be returned.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$SourceId="2c918085842e69ae018432d22ccb212f"# String | The Source id# List Schema Attributes Non-Employee Sourcetry{Get-BetaNonEmployeeSourceSchemaAttributes-BetaSourceId$SourceId# Below is a request that includes all optional parameters# Get-BetaNonEmployeeSourceSchemaAttributes -BetaSourceId $SourceId }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeSourceSchemaAttributes"Write-Host$_.ErrorDetails}
The CSV was accepted to be bulk inserted now or at a later time.
NonEmployeeBulkUploadJob
400
Client Error - Returned if the request body is invalid. The response body will contain the list of specific errors with one on each line.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: multipart/form-data
Accept: application/json
Example
$Id="e136567de87e4d029e60b3c3c55db56d"# String | Source Id (UUID)$Data=# System.IO.FileInfo | # Imports, or Updates, Non-Employee Recordstry{Import-BetaNonEmployeeRecordsInBulk-BetaId$Id-BetaData$Data# Below is a request that includes all optional parameters# Import-BetaNonEmployeeRecordsInBulk -BetaId $Id -BetaData $Data }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Import-BetaNonEmployeeRecordsInBulk"Write-Host$_.ErrorDetails}
Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.
Query
Count
Boolean
(optional) (default to $false)
If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.
Query
Filters
String
(optional)
Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: approvalStatus: eq
Query
Sorters
String
(optional)
Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: created, modified
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$RequestedFor="ac10d20a-841e-1e7d-8184-32d2e22c0179"# String | The identity for whom the request was made. *me* indicates the current user. (optional)$Limit=250# Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)$Offset=0# Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)$Count=$true# Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)$Filters='approvalStatus eq "PENDING"'# String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **approvalStatus**: *eq* (optional)$Sorters="created"# String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **created, modified** (optional)# Get List of Non-Employee Approval Requeststry{Get-BetaNonEmployeeApproval# Below is a request that includes all optional parameters# Get-BetaNonEmployeeApproval -BetaRequestedFor $RequestedFor -BetaLimit $Limit -BetaOffset $Offset -BetaCount $Count -BetaFilters $Filters -BetaSorters $Sorters }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeApproval"Write-Host$_.ErrorDetails}
Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.
Query
Count
Boolean
(optional) (default to $false)
If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.
Query
Sorters
String
(optional)
Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: id, accountName, sourceId, manager, firstName, lastName, email, phone, startDate, endDate, created, modified
Query
Filters
String
(optional)
Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: sourceId: eq
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$Limit=250# Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)$Offset=0# Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)$Count=$true# Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)$Sorters="accountName,sourceId"# String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **id, accountName, sourceId, manager, firstName, lastName, email, phone, startDate, endDate, created, modified** (optional)$Filters='sourceId eq "2c91808568c529c60168cca6f90c1313"'# String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **sourceId**: *eq* (optional)# List Non-Employee Recordstry{Get-BetaNonEmployeeRecords# Below is a request that includes all optional parameters# Get-BetaNonEmployeeRecords -BetaLimit $Limit -BetaOffset $Offset -BetaCount $Count -BetaSorters $Sorters -BetaFilters $Filters }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeRecords"Write-Host$_.ErrorDetails}
Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.
Query
Count
Boolean
(optional) (default to $false)
If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.
Query
Sorters
String
(optional)
Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: created, approvalStatus, firstName, lastName, email, phone, accountName, startDate, endDate
Query
Filters
String
(optional)
Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: sourceId: eq
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$RequestedFor="me"# String | The identity for whom the request was made. *me* indicates the current user.$Limit=250# Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)$Offset=0# Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)$Count=$true# Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)$Sorters="approvalStatus,firstName"# String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **created, approvalStatus, firstName, lastName, email, phone, accountName, startDate, endDate** (optional)$Filters='sourceId eq "2c91808568c529c60168cca6f90c1313"'# String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **sourceId**: *eq* (optional)# List Non-Employee Requeststry{Get-BetaNonEmployeeRequests-BetaRequestedFor$RequestedFor# Below is a request that includes all optional parameters# Get-BetaNonEmployeeRequests -BetaRequestedFor $RequestedFor -BetaLimit $Limit -BetaOffset $Offset -BetaCount $Count -BetaSorters $Sorters -BetaFilters $Filters }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeRequests"Write-Host$_.ErrorDetails}
Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.
Query
Count
Boolean
(optional) (default to $false)
If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.
Query
Sorters
String
(optional)
Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: name, created, sourceId
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
$RequestedFor="me"# String | The identity for whom the request was made. *me* indicates the current user.$NonEmployeeCount=$false# Boolean | The flag to determine whether return a non-employee count associate with source.$Limit=250# Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)$Offset=0# Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)$Count=$true# Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)$Sorters="name,created"# String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, sourceId** (optional)# List Non-Employee Sourcestry{Get-BetaNonEmployeeSources-BetaRequestedFor$RequestedFor-BetaNonEmployeeCount$NonEmployeeCount# Below is a request that includes all optional parameters# Get-BetaNonEmployeeSources -BetaRequestedFor $RequestedFor -BetaNonEmployeeCount $NonEmployeeCount -BetaLimit $Limit -BetaOffset $Offset -BetaCount $Count -BetaSorters $Sorters }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Get-BetaNonEmployeeSources"Write-Host$_.ErrorDetails}
A list of non-employee update operations according to the JSON Patch standard. Attributes are restricted by user type. Owner of source can update end date. Organization admins can update all available fields.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json-patch+json
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-employee record id (UUID)# JsonPatchOperation[] | A list of non-employee update operations according to the [JSON Patch](https://tools.ietf.org/html/rfc6902) standard. Attributes are restricted by user type. Owner of source can update end date. Organization admins can update all available fields.$JsonPatchOperation=@"{
"op" : "replace",
"path" : "/description",
"value" : "Newdescription"
}"@# Patch Non-Employee Recordtry{$Result=ConvertFrom-JsonToJsonPatchOperation-Json$JsonPatchOperationUpdate-BetaNonEmployeeRecord-BetaId$Id-BetaJsonPatchOperation$Result# Below is a request that includes all optional parameters# Update-BetaNonEmployeeRecord -BetaId $Id -BetaJsonPatchOperation $JsonPatchOperation }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Update-BetaNonEmployeeRecord"Write-Host$_.ErrorDetails}
A list of schema attribute update operations according to the JSON Patch standard. The following properties are allowed for update ':' 'label', 'helpText', 'placeholder', 'required'.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json-patch+json
Accept: application/json
Example
$AttributeId="2c91808b6ef1d43e016efba0ce470904"# String | The Schema Attribute Id (UUID)$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | The Source id# JsonPatchOperation[] | A list of schema attribute update operations according to the [JSON Patch](https://tools.ietf.org/html/rfc6902) standard. The following properties are allowed for update ':' 'label', 'helpText', 'placeholder', 'required'.$JsonPatchOperation=@"{
"op" : "replace",
"path" : "/description",
"value" : "Newdescription"
}"@# Patch Non-Employee Source's Schema Attributetry{$Result=ConvertFrom-JsonToJsonPatchOperation-Json$JsonPatchOperationUpdate-BetaNonEmployeeSchemaAttribute-BetaAttributeId$AttributeId-BetaSourceId$SourceId-BetaJsonPatchOperation$Result# Below is a request that includes all optional parameters# Update-BetaNonEmployeeSchemaAttribute -BetaAttributeId $AttributeId -BetaSourceId $SourceId -BetaJsonPatchOperation $JsonPatchOperation }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Update-BetaNonEmployeeSchemaAttribute"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json-patch+json
Accept: application/json
Example
$SourceId="2c91808b6ef1d43e016efba0ce470904"# String | Source Id# JsonPatchOperation[] | A list of non-employee source update operations according to the [JSON Patch](https://tools.ietf.org/html/rfc6902) standard.$JsonPatchOperation=@"{
"op" : "replace",
"path" : "/description",
"value" : "Newdescription"
}"@# Patch a Non-Employee Sourcetry{$Result=ConvertFrom-JsonToJsonPatchOperation-Json$JsonPatchOperationUpdate-BetaNonEmployeeSource-BetaSourceId$SourceId-BetaJsonPatchOperation$Result# Below is a request that includes all optional parameters# Update-BetaNonEmployeeSource -BetaSourceId $SourceId -BetaJsonPatchOperation $JsonPatchOperation }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Update-BetaNonEmployeeSource"Write-Host$_.ErrorDetails}
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$Id="MyId"# String | Non-Employee approval item id (UUID)$NonEmployeeRejectApprovalDecision=@"{
"comment" : "comment"
}"@# Reject a Non-Employee Requesttry{$Result=ConvertFrom-JsonToNonEmployeeRejectApprovalDecision-Json$NonEmployeeRejectApprovalDecisionDeny-BetaNonEmployeeRequest-BetaId$Id-BetaNonEmployeeRejectApprovalDecision$Result# Below is a request that includes all optional parameters# Deny-BetaNonEmployeeRequest -BetaId $Id -BetaNonEmployeeRejectApprovalDecision $NonEmployeeRejectApprovalDecision }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Deny-BetaNonEmployeeRequest"Write-Host$_.ErrorDetails}
Non-employee record creation request body. Attributes are restricted by user type. Owner of source can update end date. Organization admins can update all available fields.
Client Error - Returned if the request body is invalid.
ErrorResponseDto
401
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
ListAccessModelMetadataAttribute401Response
403
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
ErrorResponseDto
404
Not Found - returned if the request URL refers to a resource or object that does not exist
ErrorResponseDto
429
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.
ListAccessModelMetadataAttribute429Response
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
$Id="2c91808b6ef1d43e016efba0ce470904"# String | Non-employee record id (UUID)$NonEmployeeRequestBody=@"{
"sourceId" : "2c91808568c529c60168cca6f90c1313",
"firstName" : "William",
"lastName" : "Smith",
"manager" : "jane.doe",
"data" : {
"description" : "Auditing"
},
"accountName" : "william.smith",
"phone" : "5125555555",
"endDate" : "2021-03-25T00:00:00-05:00",
"email" : "william.smith@example.com",
"startDate" : "2020-03-24T00:00:00-05:00"
}"@# Update Non-Employee Recordtry{$Result=ConvertFrom-JsonToNonEmployeeRequestBody-Json$NonEmployeeRequestBodyUpdate-BetaNonEmployeeRecord-BetaId$Id-BetaNonEmployeeRequestBody$Result# Below is a request that includes all optional parameters# Update-BetaNonEmployeeRecord -BetaId $Id -BetaNonEmployeeRequestBody $NonEmployeeRequestBody }catch{Write-Host$_.Exception.Response.StatusCode.value__"Exception occurred when calling Update-BetaNonEmployeeRecord"Write-Host$_.ErrorDetails}