Update/Delete Members of an Adhoc Task
put
/process/api/v1/tasks/{id}/members
User with MANAGE permission can update and delete members of an adhoc task.
Request
Path Parameters
-
id(required): string
Adhoc task ID
Header Parameters
-
oci-original-url:
Endpoint requested by customer
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
action: string
Example:
addMembers(to add the list of members), updateMembers(to update the list of members), deleteAllMembers(to delete all the members), deleteMembers(to delete the list of members)
-
items: array
items
-
overwrite: string
Default Value:
always
Allowed Values:[ "always", "never", "upgradeOnly", "downgradeOnly", "upgradeonly", "downgradeonly" ]
Example:always(always add the member's permission), never (skips updating the already present members in list, updates the others), downgradeOnly (update permission if the existing permission is higher than specified), upgradeOnly (update permission if the existing permission is lower than specified)
Nested Schema : Member
Type:
Show Source
object
-
identityId: string
The identity ID of the member
-
identityName: string
The identity name of the member
-
identityType: string
The identity type of the member
-
label: string
The label of the member
-
level: string
Allowed Values:
[ "INSPECT", "READ", "USE", "MANAGE" ]
The permission level of the member
Examples
Back to Top
Response
Supported Media Types
- application/json
- text/plain
200 Response
Member(s) Successfully updated
Nested Schema : Link
Type:
object
Defines Link
Show Source
-
code: integer
Minimum Value:
100
Maximum Value:600
-
href(required): string
-
hreflang: string
-
length: integer
(int32)
-
mediaType: string
-
message: string
-
rel(required): string
-
title: string
-
type: string
Nested Schema : Member
Type:
Show Source
object
-
identityId: string
The identity ID of the member
-
identityName: string
The identity name of the member
-
identityType: string
The identity type of the member
-
label: string
The label of the member
-
level: string
Allowed Values:
[ "INSPECT", "READ", "USE", "MANAGE" ]
The permission level of the member
Examples
400 Response
Bad request
Examples
401 Response
Unauthorized
404 Response
Adhoc task ID not found
Examples
429 Response
Too many requests
500 Response
Internal server error
Examples
503 Response
Too many exceptions or too slow requests