Get an Approval task
get
/access-governance/access-controls/20250331/approvals/{taskId}
Returns details of an approval task with a given ID.
Request
Path Parameters
-
taskId(required): string
Unique approval task identifier.
Header Parameters
-
opc-request-id: string
The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Response
Supported Media Types
- application/json
200 Response
The details of an Approval task.
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Task
Type:
object
The details of a process instance task.
Show Source
-
assignee:
string
User who is assigned to the task.
-
context:
object InstanceContext
Context data pertaining to the process instance.
-
id(required):
string
Unique identifier of the task provided by BPMN provider.
-
instanceId:
string
Process instance ID.
-
lastAction:
object TaskAction
An action which can be performed for a given task.
-
processId:
string
Process definition ID.
-
requestId:
string
Request ID which is generated by the caller.
-
status:
string
Allowed Values:
[ "PENDING_APPROVAL", "APPROVED", "ASSIGNED", "MODIFIED", "REJECTED", "REMOVED", "DELETED", "INFO_REQUESTED", "EXTENSION_REQUESTED", "ESCALATED", "ERROR", "CANCELLED" ]
The status of the task. -
timeCompleted:
string(date-time)
The completion date of the task.
-
timeCreated:
string(date-time)
The creation date of the task.
-
timeDue:
string(date-time)
The due date of the task.
Nested Schema : InstanceContext
Type:
object
Context data pertaining to the process instance.
Show Source
-
assignmentAttributes:
object assignmentAttributes
Additional Properties Allowed: additionalPropertiesMap for additional key, value string pairs.
-
assignmentDescription:
string
Description of the assignment that is being requested.
-
assignmentName:
string
Name of the assignment that is being requested.
-
assignmentTags:
array assignmentTags
Assignment tags.
-
assignmentType:
string
Type of the assignment that is being requested.
-
beneficiary:
string
Display name of the process instance beneficiary.
-
instanceVariables:
array instanceVariables
Client specific context.
-
justification:
string
Reason for the request.
-
message:
string
Correlation message name.
-
requestor:
string
Display name of the process instance requestor.
-
timeCreated:
string(date-time)
The creation date of the process instance.
-
timeOfExpiration:
string(date-time)
Assignment expiration date if approval is granted.
-
timers:
array timers
Timers to update.
Nested Schema : TaskAction
Type:
object
An action which can be performed for a given task.
Show Source
-
action(required):
string
Allowed Values:
[ "REQUEST_INFO", "PROVIDE_INFO", "APPROVE", "MODIFY", "REASSIGN", "ASSIGN", "REMOVE", "REJECT", "CANCEL" ]
The action type. -
comment:
string
Reason for the action.
-
id:
string
Unique identifier of the task action.
-
parentId:
string
Identifier of the parent action, if one exists.
-
timeCreated:
string(date-time)
The creation date of the task.
-
user:
string
User who is performing the action.
Nested Schema : assignmentAttributes
Type:
object
Additional Properties Allowed
Show Source
Map for additional key, value string pairs.
Nested Schema : assignmentTags
Type:
array
Assignment tags.
Show Source
-
Array of:
string
Allowed Values:
[ "SOD_VIOLATIONS", "EXPIRES_SOON", "EXTENSION_REQUEST" ]
Nested Schema : instanceVariables
Type:
array
Client specific context.
Show Source
-
Array of:
object InstanceVariable
Variable of process instance
Nested Schema : timers
Type:
array
Timers to update.
Show Source
-
Array of:
object InstanceTimer
Timers of process instance
Nested Schema : InstanceVariable
Type:
object
Variable of process instance
Show Source
-
name:
string
variable name
-
value:
object value
value assigned to the variable
-
valuetype:
string
The value type of the variable. It can be string, boolean, integer, long , double
Nested Schema : InstanceTimer
Type:
object
Timers of process instance
Show Source
-
id:
string
Timer id
-
value:
string
Timer value
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
Default Response
Unknown Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
Error Information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error string.
Examples
The following example shows how to fetch details for a specific approval task.
cURL Request Example
curl -i -X GET \
-H "Authorization:Bearer <your access token>" \
'https://<host>/access-governance/access-controls/20250331/approvals/${approvaltaskID}'
Example of the Response Code
You'll receive 200 OK
response along with the following response body:
{
"id" : "d7ca9xxx-xxxx-11f0-a4f0-ce0355309xxx",
"processId" : "Guid_18220xxx-a280-4c64-a4b7-e00fb4axxxxx",
"instanceId" : "ae3a3xxx-5fbe-4503-bdea-67ea84xxx4114b:d60b0xxx-1efa-11f0-bd85-ba97ac6xxxxx",
"requestId" : "d2756xxx-0deb-4a90-bd2a-a31f13xxxxx",
"assignee" : "Betty Cook",
"status" : "PENDING APPROVAL",
"lastAction" : null,
"context" : {
"requestor" : "Amel Maclead",
"beneficiary" : "Bill Clark",
"assignmentName" : "DBUM-Access-Bundle-Request",
"assignmentType" : "DBUM_ACCESS_BUNDLE",
"assignmentDescription" : "Request for Database User Management Access Bundle",
"assignmentAttributes" : null,
"assignmentTags" : [ ],
"timeOfExpiration" : null,
"justification" : "Requesting DBUM basic privileges",
"timeCreated" : "2025-04-21T21:51:53.008Z",
"instanceVariables" : null,
"message" : null,
"timers" : null
},
"timeDue" : "2025-04-28T21:51:55.953Z",
"timeCreated" : "2025-04-21T21:51:55.952Z",
"timeCompleted" : null
}