---
title: PushUserDevices
description: The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query
component: pingam
version: 8.1
page_id: pingam:entity-reference:sec-amster-entity-pushuserdevices
canonical_url: https://docs.pingidentity.com/pingam/8.1/entity-reference/sec-amster-entity-pushuserdevices.html
section_ids:
  sec-amster-entity-pushuserdevices-realm-ops: Realm Operations
  sec-amster-entity-pushuserdevices-realm-ops-check: check
  sec-amster-entity-pushuserdevices-realm-ops-delete: delete
  sec-amster-entity-pushuserdevices-realm-ops-query: query
  sec-amster-entity-pushuserdevices-realm-ops-reset: reset
  sec-amster-entity-pushuserdevices-realm-ops-skip: skip
  sec-amster-entity-pushuserdevices-realm-ops-update: update
---

# PushUserDevices

## Realm Operations

The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

Resource path:

```
/users/{user}/devices/2fa/push
```

Resource version: `1.0`

### check

Checks if the user's Authenticator Push module is 'skippable' and returns the result as a boolean

**Usage**

```
am> action PushUserDevices --realm Realm --body body --user user --actionName check
```

**Parameters**

* *\--body*

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

  ```json
  {
    "$schema" : "http://json-schema.org/draft-04/schema#",
    "description" : "Push user device check action request schema",
    "type" : "object",
    "title" : "Push user device check action request schema"
  }
  ```

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

### delete

Delete Push user device

**Usage**

```
am> delete PushUserDevices --realm Realm --id id --user user
```

**Parameters**

* *\--id*

  The unique identifier for the resource.

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

### query

Query the user's device profile

**Usage**

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

**Parameters**

* *\--filter*

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

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

### reset

Sets the user's 'skippable' selection of Authenticator Push module to default (NOT\_SET) and deletes their profile's attribute

**Usage**

```
am> action PushUserDevices --realm Realm --body body --user user --actionName reset
```

**Parameters**

* *\--body*

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

  ```json
  {
    "$schema" : "http://json-schema.org/draft-04/schema#",
    "description" : "Push user device reset action request schema",
    "type" : "object",
    "title" : "Push user device reset action request schema"
  }
  ```

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

### skip

Sets the user's ability to skip an Authenticator Push module

**Usage**

```
am> action PushUserDevices --realm Realm --body body --user user --actionName skip
```

**Parameters**

* *\--body*

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

  ```json
  {
    "description" : "Push user device skip action request schema",
    "type" : "object",
    "title" : "Push user device skip action request schema",
    "properties" : {
      "value" : {
        "type" : "boolean",
        "title" : "Skip push module response value",
        "description" : "True if the push device is set to skipped"
      }
    },
    "required" : [ "value" ]
  }
  ```

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query

### update

Update an existing Push user device

**Usage**

```
am> update PushUserDevices --realm Realm --id id --body body --user user
```

**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" : "User devices schema that is used for push authentication devices, trusted user devices and oath user devices",
    "type" : "object",
    "title" : "User devices schema",
    "properties" : {
      "deviceName" : {
        "type" : "string",
        "title" : "Name",
        "description" : "Device name"
      },
      "uuid" : {
        "type" : "string",
        "title" : "Device id",
        "description" : "Device unique identifier"
      }
    }
  }
  ```

* *\--user*

  The Push devices service is responsible for exposing functions to change the collection of Push authentication devices. The supported methods are action, delete, query