---
title: pingctl pingone
description: The pingctl utility referenced here has been deprecated and is no longer being maintained. It is recommended to use the Ping CLI utility under active development and support.
component: devops
page_id: devops::tools/commands/pingone
canonical_url: https://developer.pingidentity.com/devops/tools/commands/pingone.html
section_ids:
  devops-pingctl-pingone: Managing PingOne environments
  devops-description: Description
  devops-usage: Usage
  devops-options: Options
  devops-all-subcommands: All subcommands
  devops-get: get
  devops-add: add
---

# pingctl pingone

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | The `pingctl` utility referenced here has been deprecated and is no longer being maintained. It is recommended to use the [Ping CLI](https://developer.pingidentity.com/pingcli/pingcli_landing_page.html) utility under active development and support.With few exceptions, `pingctl pingone` commands can be replicated using the `pingcli request --service pingone` subcommand. See [this page](https://developer.pingidentity.com/pingcli/command_reference/pingcli_request.html) for details.Gaps between `pingctl` and `pingcli` are being addressed based on prioritization and equivalent commands from other tools. |

## Managing PingOne environments

### Description

Provides ability to manage PingOne environments. Capabilities of this command include:

* Listing, searching and retrieving PingOne resources (i.e. user, populations, groups)

* Adding PingOne resources

* Deleting PingOne resources

To manage PingOne resources using credentials other than your own, a PingOne Worker App is required. See [this configuration page](../../reference/pingone-config.html) for more details.

### Usage

```none
pingctl pingone get                  # Get PingOne resource(s)
pingctl pingone add                  # Add PingOne resource
pingctl pingone delete               # Delete PingOne resource

pingctl pingone add-user-group       # Add group to user
pingctl pingone delete-user-group    # Delete group from user

pingctl pingone token                # Obtain access token
```

### Options

#### All subcommands

```none
 -r
     Provide REST Calls
```

#### get

```none
-o [ table | csv | json ]
    Output format (default: table)
    also set with env variable: PINGCTL_DEFAULT_OUTPUT

-i {id}
    Search based on object guid

-n {name}
    Search based on exact filter

-f {filter}
    PingOne filter (SCIM based)
        ex: '.name.given eq "john"'
            '.email sw "john"'

-c {columns}
    Columns to output based on "heading:jsonAttr"
    An example of available jsonAttrs can be found by using a json output first.
        ex: 'LastName:name.family,FirstName:name.given'

-s {sort column}
    Columns to sort output on based on "jsonAttr"
    The jsonAttr MUST be listed in the list of columns (-c option).
        ex: 'name.family'

-p {population name}
    Population from which to retrieve a user/group
    If not provided, the 'Default' population is used
```

#### add

```none
 -p {population name}
     Population into which to add a user/group
     If not provided, the 'Default' population is used
```