---
title: PendingUmaRequests
description: Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)
component: pingam
version: 8.1
page_id: pingam:entity-reference:sec-amster-entity-pendingumarequests
canonical_url: https://docs.pingidentity.com/pingam/8.1/entity-reference/sec-amster-entity-pendingumarequests.html
section_ids:
  sec-amster-entity-pendingumarequests-realm-ops: Realm Operations
  sec-amster-entity-pendingumarequests-realm-ops-approve: approve
  sec-amster-entity-pendingumarequests-realm-ops-approveall: approveAll
  sec-amster-entity-pendingumarequests-realm-ops-query: query
  sec-amster-entity-pendingumarequests-realm-ops-read: read
---

# PendingUmaRequests

## Realm Operations

Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)

Resource path:

```
/users/{user}/uma/pendingrequests
```

Resource version: `1.0`

### approve

Approve the pending request and grant access to the requesting user.

**Usage**

```
am> action PendingUmaRequests --realm Realm --id id --body body --user user --actionName approve
```

**Parameters**

* *\--id*

  The unique identifier for the resource.

* *\--body*

  The resource in JSON format, described by the following JSON schema:

  ```json
  {
    "$schema" : "http://json-schema.org/draft-04/schema#",
    "description" : "Approve action request schema.",
    "type" : "object",
    "title" : "Approve action request schema",
    "properties" : {
      "scopes" : {
        "type" : "array",
        "title" : "Approve request scopes",
        "description" : "The list of the scopes the requesting user gets access to.",
        "items" : {
          "type" : "string"
        }
      }
    },
    "required" : [ "scopes" ]
  }
  ```

* *\--user*

  Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)

### approveAll

Approve every pending requests and grant access to the requesting user.

**Usage**

```
am> action PendingUmaRequests --realm Realm --body body --user user --actionName approveAll
```

**Parameters**

* *\--body*

  The resource in JSON format, described by the following JSON schema:

  ```json
  {
    "$schema" : "http://json-schema.org/draft-04/schema#",
    "description" : "Approve action request schema.",
    "type" : "object",
    "title" : "Approve action request schema",
    "properties" : {
      "scopes" : {
        "type" : "array",
        "title" : "Approve request scopes",
        "description" : "The list of the scopes the requesting user gets access to.",
        "items" : {
          "type" : "string"
        }
      }
    },
    "required" : [ "scopes" ]
  }
  ```

* *\--user*

  Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)

### query

Query the collection of pending requests.

**Usage**

```
am> query PendingUmaRequests --realm Realm --filter filter --user user
```

**Parameters**

* *\--filter*

  A CREST formatted query filter, where "true" will query all. Fields that can be queried: \[\*]

* *\--user*

  Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)

### read

Read pending request

**Usage**

```
am> read PendingUmaRequests --realm Realm --id id --user user
```

**Parameters**

* *\--id*

  The unique identifier for the resource.

* *\--user*

  Pending UMA requests provider is responsible for allowing, denying and querying the guest requests for user resources. Awailable actions are Query, Read, Deny (all requests or one request), Approve (all requests or one request)