Use this API to implement work reassignment functionality.
Work Reassignment allows access request reviews, certifications, and manual provisioning tasks assigned to a user to be reassigned to a different user. This is primarily used for:
Temporarily redirecting work for users who are out of office, such as on vacation or sick leave
Permanently redirecting work for users who should not be assigned these tasks at all, such as senior executives or service identities
Users can define reassignments for themselves, managers can add them for their team members, and administrators can configure them on any user’s behalf. Work assigned during the specified reassignment timeframes will be automatically reassigned to the designated user as it is created.
:::warning experimental
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.
:::
Create a Reassignment Configuration
Creates a new Reassignment Configuration for the specified identity.
The newly created Reassignment Configuration object
ConfigurationItemResponse
-
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.configuration_item_requestimportConfigurationItemRequestfromsailpoint.v2024.models.configuration_item_responseimportConfigurationItemResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')configuration_item_request={"endDate":"2022-07-30T17:00:00Z","reassignedFromId":"2c91808781a71ddb0181b9090b5c504e","configType":"ACCESS_REQUESTS","reassignedToId":"2c91808781a71ddb0181b9090b53504a","startDate":"2022-07-21T11:13:12.345Z"}# ConfigurationItemRequest | try:# Create a Reassignment ConfigurationResult=configuration_item_request.from_json(configuration_item_request)api_response=api_instance.create_reassignment_configuration(x_sail_point_experimental,Result)# Below is a request that includes all optional parameters# api_response = api_instance.create_reassignment_configuration(x_sail_point_experimental, Result)print("The response of WorkReassignmentApi->create_reassignment_configuration:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->create_reassignment_configuration: %s\n"%e)
:::warning experimental
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.
:::
Delete Reassignment Configuration
Deletes a single reassignment configuration for the specified identity
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.config_type_enumimportConfigTypeEnumfromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintidentity_id='2c91808781a71ddb0181b9090b5c504e'# str | unique identity id # str | unique identity idconfig_type=sailpoint.v2024.ConfigTypeEnum()# ConfigTypeEnum | # ConfigTypeEnum | x_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')try:# Delete Reassignment Configurationapi_instance.delete_reassignment_configuration(identity_id,config_type,x_sail_point_experimental)# Below is a request that includes all optional parameters# api_instance.delete_reassignment_configuration(identity_id, config_type, x_sail_point_experimental)exceptExceptionase:print("Exception when calling WorkReassignmentApi->delete_reassignment_configuration: %s\n"%e)
:::warning experimental
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.
:::
Evaluate Reassignment Configuration
Evaluates the Reassignment Configuration for an Identity to determine if work items for the specified type should be reassigned. If a valid Reassignment Configuration is found for the identity & work type, then a lookup is initiated which recursively fetches the Reassignment Configuration for the next TargetIdentity until no more results are found or a max depth of 5. That lookup trail is provided in the response and the final reassigned identity in the lookup list is returned as the reassignToId property. If no Reassignment Configuration is found for the specified identity & config type then the requested Identity ID will be used as the reassignToId value and the lookupTrail node will be empty.
Exclusion filters that disable parts of the reassignment evaluation. Possible values are listed below: - SELF_REVIEW_DELEGATION: This will exclude delegations of self-review reassignments
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.config_type_enumimportConfigTypeEnumfromsailpoint.v2024.models.evaluate_responseimportEvaluateResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintidentity_id='2c91808781a71ddb0181b9090b5c504e'# str | unique identity id # str | unique identity idconfig_type=sailpoint.v2024.ConfigTypeEnum()# ConfigTypeEnum | Reassignment work type # ConfigTypeEnum | Reassignment work typex_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')exclusion_filters=['SELF_REVIEW_DELEGATION']# List[str] | Exclusion filters that disable parts of the reassignment evaluation. Possible values are listed below: - `SELF_REVIEW_DELEGATION`: This will exclude delegations of self-review reassignments (optional)exclusion_filters=['SELF_REVIEW_DELEGATION']# List[str] | Exclusion filters that disable parts of the reassignment evaluation. Possible values are listed below: - `SELF_REVIEW_DELEGATION`: This will exclude delegations of self-review reassignments (optional)try:# Evaluate Reassignment Configurationapi_response=api_instance.get_evaluate_reassignment_configuration(identity_id,config_type,x_sail_point_experimental,)# Below is a request that includes all optional parameters# api_response = api_instance.get_evaluate_reassignment_configuration(identity_id, config_type, x_sail_point_experimental, exclusion_filters)print("The response of WorkReassignmentApi->get_evaluate_reassignment_configuration:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->get_evaluate_reassignment_configuration: %s\n"%e)
:::warning experimental
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.
:::
List Reassignment Config Types
Gets a collection of types which are available in the Reassignment Configuration UI.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.config_typeimportConfigTypefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')try:# List Reassignment Config Typesapi_response=api_instance.get_reassignment_config_types(x_sail_point_experimental)# Below is a request that includes all optional parameters# api_response = api_instance.get_reassignment_config_types(x_sail_point_experimental)print("The response of WorkReassignmentApi->get_reassignment_config_types:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->get_reassignment_config_types: %s\n"%e)
:::warning experimental
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.
:::
Get Reassignment Configuration
Gets the Reassignment Configuration for an identity.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.configuration_responseimportConfigurationResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintidentity_id='2c91808781a71ddb0181b9090b5c504f'# str | unique identity id # str | unique identity idx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')try:# Get Reassignment Configurationapi_response=api_instance.get_reassignment_configuration(identity_id,x_sail_point_experimental)# Below is a request that includes all optional parameters# api_response = api_instance.get_reassignment_configuration(identity_id, x_sail_point_experimental)print("The response of WorkReassignmentApi->get_reassignment_configuration:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->get_reassignment_configuration: %s\n"%e)
:::warning experimental
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.
:::
Get Tenant-wide Reassignment Configuration settings
Gets the global Reassignment Configuration settings for the requestor's tenant.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.tenant_configuration_responseimportTenantConfigurationResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')try:# Get Tenant-wide Reassignment Configuration settingsapi_response=api_instance.get_tenant_config_configuration(x_sail_point_experimental)# Below is a request that includes all optional parameters# api_response = api_instance.get_tenant_config_configuration(x_sail_point_experimental)print("The response of WorkReassignmentApi->get_tenant_config_configuration:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->get_tenant_config_configuration: %s\n"%e)
:::warning experimental
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.
:::
List Reassignment Configurations
Gets all Reassignment configuration for the current org.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: Not defined
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.configuration_responseimportConfigurationResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')try:# List Reassignment Configurationsapi_response=api_instance.list_reassignment_configurations(x_sail_point_experimental)# Below is a request that includes all optional parameters# api_response = api_instance.list_reassignment_configurations(x_sail_point_experimental)print("The response of WorkReassignmentApi->list_reassignment_configurations:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->list_reassignment_configurations: %s\n"%e)
:::warning experimental
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.
:::
Update Reassignment Configuration
Replaces existing Reassignment configuration for an identity with the newly provided configuration.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.configuration_item_requestimportConfigurationItemRequestfromsailpoint.v2024.models.configuration_item_responseimportConfigurationItemResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintidentity_id='2c91808781a71ddb0181b9090b5c504e'# str | unique identity id # str | unique identity idx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')configuration_item_request={"endDate":"2022-07-30T17:00:00Z","reassignedFromId":"2c91808781a71ddb0181b9090b5c504e","configType":"ACCESS_REQUESTS","reassignedToId":"2c91808781a71ddb0181b9090b53504a","startDate":"2022-07-21T11:13:12.345Z"}# ConfigurationItemRequest | try:# Update Reassignment ConfigurationResult=configuration_item_request.from_json(configuration_item_request)api_response=api_instance.put_reassignment_config(identity_id,x_sail_point_experimental,Result)# Below is a request that includes all optional parameters# api_response = api_instance.put_reassignment_config(identity_id, x_sail_point_experimental, Result)print("The response of WorkReassignmentApi->put_reassignment_config:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->put_reassignment_config: %s\n"%e)
:::warning experimental
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.
:::
Update Tenant-wide Reassignment Configuration settings
Replaces existing Tenant-wide Reassignment Configuration settings with the newly provided settings.
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.
ListAccessProfiles401Response
-
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.
ListAccessProfiles429Response
-
500
Internal Server Error - Returned if there is an unexpected error.
ErrorResponseDto
-
HTTP request headers
Content-Type: application/json
Accept: application/json
Example
importsailpoint.v2024fromsailpoint.v2024.models.tenant_configuration_requestimportTenantConfigurationRequestfromsailpoint.v2024.models.tenant_configuration_responseimportTenantConfigurationResponsefromsailpoint.v2024.restimportApiExceptionfrompprintimportpprintx_sail_point_experimental='true'# str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')tenant_configuration_request={"configDetails":{"disabled":true}}# TenantConfigurationRequest | try:# Update Tenant-wide Reassignment Configuration settingsResult=tenant_configuration_request.from_json(tenant_configuration_request)api_response=api_instance.put_tenant_configuration(x_sail_point_experimental,Result)# Below is a request that includes all optional parameters# api_response = api_instance.put_tenant_configuration(x_sail_point_experimental, Result)print("The response of WorkReassignmentApi->put_tenant_configuration:\n")pprint(api_response)exceptExceptionase:print("Exception when calling WorkReassignmentApi->put_tenant_configuration: %s\n"%e)