Update Provisioning Task
/iam/governance/selfservice/api/v1/provtasks/{taskid}
Request
- application/json
-
taskid(required): string
Task ID
Response
- application/json
200 Response
-
ResponseTime: string
Captures the time in milliseconds taken for processing the request.
401 Response
403 Response
404 Response
500 Response
Default Response
Examples
Example to Show How to Update a Provisioning Task
The following example shows how to update a provisioning task by submitting a PUT request on the REST resource using cURL. The information shown here is against a pseudo system and serves as a prototype. For more information about cURL, see Use cURL.
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/3009
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{ "action": "reassign", "fields": [ { "name": "assignee", "value": "23" }, { "name": "type", "value": "user" } ] }
Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/3009" } ], "id": "3009", "status": "SUCCESS" }
Example to Show How to Update a Note in a Given Provisioning Task
The following example shows how to update a note in a given Provisioning task by its ID by submitting a PUT request on the REST resource using cURL. The information shown here is against a pseudo system and serves as a prototype.
curl -X PUT --verbose -k -1 -H "Content-Type: application/json" -H "X-Requested-By: provtask" -u username:password -d '{ "action": "setNote", "fields" : [ { "name": "Process Instance.Task Details.Note", "value": "Updated value of Note-NB" } ] }'https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{ "action": "setNote", "fields" : [ { "name": "Process Instance.Task Details.Note", "value": "Updated value of Note-NB" } ] }
Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6" } ], "id": "6", "status": "SUCCESS" }
Example to Show How to Update a Response in a Given Provisioning Task
The following example shows how to update a response in given provisioning task by its ID by submitting a PUT request on the REST resource using cURL. The information shown here is against a pseudo system and serves as a prototype.
curl -X PUT --verbose -k -1 -H "Content-Type: application/json" -H "X-Requested-By: provtask" -u username:password -d '{ "action": "setResponse", "fields" : [ { "name": "Process Definition.Tasks.Responses.Response", "value": "VALIDATION_FAILED" } ] }'https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{ "action": "setResponse", "fields" : [ { "name": "Process Definition.Tasks.Responses.Response", "value": "VALIDATION_FAILED" } ] }
Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6" } ], "id": "6", "status": "SUCCESS" }
Example to Show How to Reassign a Given Provisioning Task
The following example shows how to reassign a given Provisioning task by its ID by submitting a PUT request on the REST resource using cURL. The information shown here is against a pseudo system and serves as a prototype.
curl -X PUT --verbose -k -1 -H "Content-Type: application/json" -H "X-Requested-By: provtask" -u username:password -d '{ "action": "reassign", "fields" : [ { "name": "type", "value": "user" }, { "name": "assignee", "value": "1001" } ] }'https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{ "action": "reassign", "fields" : [ { "name": "type", "value": "user" }, { "name": "assignee", "value": "1" } ] }
Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6" }, { "rel": "assignee", "href": "https://pseudo.com/iam/governance/selfservice/api/v1//users/1" } ], "id": "6", "status": "SUCCESS" }
Example to Show How to Retry a Given Provisioning Task
The following example shows how to retry a given provisioning task by its ID by submitting a PUT request on the REST resource using cURL. The information shown here is against a pseudo system and serves as a prototype.
curl -X PUT --verbose -k -1 -H "Content-Type: application/json" -H "X-Requested-By: provtask" -u username:password -d '{ "action": "retry" }'https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{ "action": "retry" }
Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/6" } ], "id": "6", "status": "SUCCESS" }