Get a list of Approval Processes
get
/access-governance/access-controls/20250331/approvalWorkflows
Returns details of all available approval workflows with support for pagination.
Request
Query Parameters
-
keywordContains: array[string]
Collection Format:
multi
Maximum Number of Items:5
The list of keywords to filter on -
limit: integer
Minimum Value:
1
Maximum Value:1000
The maximum number of items to return.Default Value:10
-
outOfBoxCategory: string
Indicates the category of out of box workflow to filter on. If specified, 'isOutOfBox' is assumed true and 'isTransition' is ignored.Allowed Values:
[ "UNMATCHED", "OWNERSHIP", "TRANSITION" ]
-
ownerId: string
Owner ID to filter on
-
page: string
Minimum Length:
1
A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response. -
processId: string
The approval process ID to filter on. If specified all existing versions of the approval process are provided.
-
sortBy: string
The field to sort by. Default sort by is displayName.Default Value:
displayName
Allowed Values:[ "displayName", "state", "creatorId", "timeCreated" ]
-
sortOrder: string
The sort order to use, either 'ASC' or 'DESC'.Allowed Values:
[ "ASC", "DESC" ]
-
state: string
A filter to return only the workflows that match the given approval process state.Allowed Values:
[ "DRAFT", "PUBLISHING", "ACTIVE", "DISABLED", "DELETING" ]
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
A page of ApprovalProcessSummary objects.
Headers
-
opc-next-page: string
For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items.
-
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 : ApprovalProcessCollection
Type:
object
Results of a approval process search.
Show Source
-
items(required):
array items
List of approval process summaries.
Nested Schema : items
Type:
array
List of approval process summaries.
Show Source
-
Array of:
object ApprovalProcessSummary
Summary of the AgcsApprovalProcess.
Nested Schema : ApprovalProcessSummary
Type:
object
Summary of the AgcsApprovalProcess.
Show Source
-
creatorId(required):
string
The ID of the creator.
-
displayName(required):
string
Minimum Length:
1
Maximum Length:100
The approval process name, must be unique. -
guid(required):
string
The global identifier for the approval process definition.
-
isDefault:
boolean
Set to true if the approval process is the default process.
-
isInDraftMode(required):
boolean
Indicates whether a draft for the approval process is available.
-
isRuntime:
boolean
Set to true if the approval process has configuration provided at runtime.
-
ownedEntityId:
string
The ownership collection owned entity ID
-
owner:
object ApprovalProcessOwner
Details of an approval process owner.
-
ownershipCollectionId:
string
The ownership collection ID
-
state(required):
string
Allowed Values:
[ "DRAFT", "PUBLISHING", "ACTIVE", "DISABLED", "DELETING" ]
The lifecycle state of the approval process. -
timeCreated(required):
string(date-time)
The time that the approval process was created.
-
timeUpdated(required):
string(date-time)
The last update date of the process.
-
updaterId(required):
string
User ID of last person that updated the process.
-
version:
integer
The version of the approval process definition.
Nested Schema : ApprovalProcessOwner
Type:
object
Details of an approval process owner.
Show Source
-
displayName(required):
string
The display name of the identity.
-
id(required):
string
Minimum Length:
1
Maximum Length:255
User ID of the identity. -
isPrimary(required):
boolean
Set to true if the user is the primary owner, set to false otherwise.
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.