mirror of
https://github.com/LukeHagar/api-specs.git
synced 2025-12-10 04:19:19 +00:00
68 lines
2.1 KiB
YAML
68 lines
2.1 KiB
YAML
get:
|
|
operationId: listPendingApprovals
|
|
summary: Pending Access Request Approvals List
|
|
tags:
|
|
- Access Request Approvals
|
|
description: >-
|
|
This endpoint returns a list of pending approvals.
|
|
See "owner-id" query parameter below for authorization info.
|
|
parameters:
|
|
- in: query
|
|
name: owner-id
|
|
schema:
|
|
type: string
|
|
description: >-
|
|
If present, the value returns only pending approvals for the specified identity.
|
|
* ORG_ADMIN users can call this with any identity ID value.
|
|
* ORG_ADMIN users can also fetch all the approvals in the org, when owner-id is not used.
|
|
* Non-ORG_ADMIN users can only specify *me* or pass their own identity ID value.
|
|
|
|
required: false
|
|
- $ref: '../../v3/parameters/limit.yaml'
|
|
- $ref: '../../v3/parameters/offset.yaml'
|
|
- $ref: '../../v3/parameters/count.yaml'
|
|
- in: query
|
|
name: filters
|
|
schema:
|
|
type: string
|
|
description: >-
|
|
Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results)
|
|
|
|
|
|
Filtering is supported for the following fields and operators:
|
|
|
|
|
|
**id**: *eq, in*
|
|
|
|
|
|
**requestedFor.id**: *eq, in*
|
|
|
|
|
|
**modified**: *gt, lt, ge, le, eq, in*
|
|
- in: query
|
|
name: sorters
|
|
schema:
|
|
type: string
|
|
format: comma-separated
|
|
description: >-
|
|
Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)
|
|
|
|
|
|
Sorting is supported for the following fields: **created, modified**
|
|
responses:
|
|
'200':
|
|
description: List of Pending Approvals.
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
$ref: '../schemas/PendingApproval.yaml'
|
|
'401':
|
|
$ref: '../../v3/responses/401.yaml'
|
|
'403':
|
|
$ref: '../../v3/responses/403.yaml'
|
|
'429':
|
|
$ref: '../../v3/responses/429.yaml'
|
|
'500':
|
|
$ref: '../../v3/responses/500.yaml' |