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
Header Parameters
  • The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Back to Top

Response

Supported Media Types

200 Response

The details of an Approval task.
Headers
  • For optimistic concurrency control. See `if-match`.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Task
Type: object
The details of a process instance task.
Show Source
Nested Schema : InstanceContext
Type: object
Context data pertaining to the process instance.
Show Source
Nested Schema : TaskAction
Type: object
An action which can be performed for a given task.
Show Source
Nested Schema : additionalAttributes
Type: object
Additional Properties Allowed
Show Source
Map for additional key, value string pairs.
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
  • Allowed Values: [ "SOD_VIOLATIONS", "EXPIRES_SOON", "EXTENSION_REQUEST" ]
Nested Schema : instanceVariables
Type: array
Client specific context.
Show Source
Nested Schema : timers
Type: array
Timers to update.
Show Source
Nested Schema : additionalProperties
Type: object
Show Source
Nested Schema : InstanceVariable
Type: object
Variable of process instance
Show Source
Nested Schema : value
Type: object
value assigned to the variable
Show Source
Nested Schema : InstanceTimer
Type: object
Timers of process instance
Show Source
Nested Schema : ApprovalTimeLimit
Type: object
Details about the approval time limit, when applicable. Only one of daysLimit, hoursLimit, or timeRangeLimit should be defined.
Show Source
Nested Schema : ExtensionTimeLimit
Type: object
Approval extension time limit definition as an end time.
Show Source
Nested Schema : ApprovalTimeLimitRange
Type: object
Approval time limit definition as a time range.
Show Source

400 Response

Bad Request
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

401 Response

Unauthorized
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

404 Response

Not Found
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

429 Response

Too Many Requests
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

500 Response

Internal Server Error
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source

Default Response

Unknown Error
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error Information.
Show Source
Back to Top

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
} 
Back to Top