Skip to content

Commit 9c129d1

Browse files
Release notes for v1.1.0 (#180)
1 parent 1ea397d commit 9c129d1

15 files changed

Lines changed: 568 additions & 6 deletions

.agents/skills/pingcli-usage/SKILL.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,8 @@ For example, `pingcli config get` → `references/cmd-pingcli-config-get.md`
196196
- [`pingcli pingfederate auth status`](references/cmd-pingcli-pingfederate-auth-status.md) — Print details of the current authenticated session.
197197
- [`pingcli pingfederate init`](references/cmd-pingcli-pingfederate-init.md) — Initialize Ping CLI for the PingFederate management APIs.
198198
- [`pingcli pingone`](references/cmd-pingcli-pingone.md) — Administration tools for the PingOne platform.
199+
- [`pingcli pingone active-identity-counts`](references/cmd-pingcli-pingone-active-identity-counts.md) — Active identity counts
200+
- [`pingcli pingone active-identity-counts list`](references/cmd-pingcli-pingone-active-identity-counts-list.md) — List active identity counts
199201
- [`pingcli pingone agreements`](references/cmd-pingcli-pingone-agreements.md) — Agreements
200202
- [`pingcli pingone agreements agreement-languages`](references/cmd-pingcli-pingone-agreements-agreement-languages.md) — Agreement Languages
201203
- [`pingcli pingone agreements agreement-languages apply`](references/cmd-pingcli-pingone-agreements-agreement-languages-apply.md) — Create or update an agreement language
@@ -255,6 +257,7 @@ For example, `pingcli config get` → `references/cmd-pingcli-config-get.md`
255257
- [`pingcli pingone auth`](references/cmd-pingcli-pingone-auth.md) — Authenticate Ping CLI to the PingOne management APIs.
256258
- [`pingcli pingone auth login`](references/cmd-pingcli-pingone-auth-login.md) — Log in to allow Ping CLI to administer PingOne
257259
- [`pingcli pingone auth logout`](references/cmd-pingcli-pingone-auth-logout.md) — Log out from PingOne
260+
- [`pingcli pingone auth refresh`](references/cmd-pingcli-pingone-auth-refresh.md) — Refresh the current authenticated session.
258261
- [`pingcli pingone auth status`](references/cmd-pingcli-pingone-auth-status.md) — Print details of the current authenticated session.
259262
- [`pingcli pingone auth token`](references/cmd-pingcli-pingone-auth-token.md) — Print the active token for the current authenticated session.
260263
- [`pingcli pingone authorize`](references/cmd-pingcli-pingone-authorize.md) — Administration tools for the PingOne Authorize universal service.
@@ -314,6 +317,14 @@ For example, `pingcli config get` → `references/cmd-pingcli-config-get.md`
314317
- [`pingcli pingone credentials digital-wallet-applications list`](references/cmd-pingcli-pingone-credentials-digital-wallet-applications-list.md) — List all digital wallet applications
315318
- [`pingcli pingone credentials digital-wallet-applications replace`](references/cmd-pingcli-pingone-credentials-digital-wallet-applications-replace.md) — Replace a digital wallet application
316319
- [`pingcli pingone credentials digital-wallet-applications template`](references/cmd-pingcli-pingone-credentials-digital-wallet-applications-template.md) — Generate a digital wallet application JSON template
320+
- [`pingcli pingone custom-admin-roles`](references/cmd-pingcli-pingone-custom-admin-roles.md) — Custom Admin Roles
321+
- [`pingcli pingone custom-admin-roles apply`](references/cmd-pingcli-pingone-custom-admin-roles-apply.md) — Create or update a custom admin role
322+
- [`pingcli pingone custom-admin-roles create`](references/cmd-pingcli-pingone-custom-admin-roles-create.md) — Create a new custom admin role
323+
- [`pingcli pingone custom-admin-roles delete`](references/cmd-pingcli-pingone-custom-admin-roles-delete.md) — Delete a custom admin role
324+
- [`pingcli pingone custom-admin-roles get`](references/cmd-pingcli-pingone-custom-admin-roles-get.md) — Read a specific custom admin role
325+
- [`pingcli pingone custom-admin-roles list`](references/cmd-pingcli-pingone-custom-admin-roles-list.md) — List all custom admin roles
326+
- [`pingcli pingone custom-admin-roles replace`](references/cmd-pingcli-pingone-custom-admin-roles-replace.md) — Update a custom admin role
327+
- [`pingcli pingone custom-admin-roles template`](references/cmd-pingcli-pingone-custom-admin-roles-template.md) — Generate a custom admin role JSON template
317328
- [`pingcli pingone davinci`](references/cmd-pingcli-pingone-davinci.md) — Administration tools for the PingOne DaVinci universal service.
318329
- [`pingcli pingone davinci applications`](references/cmd-pingcli-pingone-davinci-applications.md) — DaVinci Applications
319330
- [`pingcli pingone davinci applications apply`](references/cmd-pingcli-pingone-davinci-applications-apply.md) — Create or update a DaVinci application
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# `pingcli pingone active-identity-counts list`
2+
List active identity counts
3+
4+
## Synopsis
5+
6+
List all active identity counts in a PingOne environment, organized by date
7+
8+
```
9+
pingcli pingone active-identity-counts list [flags]
10+
```
11+
12+
## Examples
13+
14+
```
15+
# List active identity counts from a start date (daily, default)
16+
pingcli pingone active-identity-counts list --environment-id <env-id> --start-date 2024-01-01T00:00:00Z
17+
18+
# List with monthly aggregation
19+
pingcli pingone active-identity-counts list --environment-id <env-id> --start-date 2024-01-01T00:00:00Z --sample-period MONTH
20+
21+
# List up to 100 daily records
22+
pingcli pingone active-identity-counts list --environment-id <env-id> --start-date 2024-01-01T00:00:00Z --limit 100
23+
```
24+
25+
## Options
26+
27+
| Flag | Default | Description |
28+
|------|---------|-------------|
29+
| `-h, --help` | `` | help for list |
30+
| `-e, --environment-id string` | `` | The PingOne environment ID |
31+
| `--limit int64` | `` | Maximum number of results to return (1-100 for DAY, 1-24 for MONTH). Defaults to 10 if not set. |
32+
| `--order string` | `` | Sort order for results. Valid values: ASC, DESC. |
33+
| `--sample-period string` | `` | Sampling period for active identity count aggregation. Valid values: DAY, MONTH. |
34+
| `--start-date string` | `` | Start date for the query in RFC3339 format (e.g. 2024-01-01T00:00:00Z). Must be within the past 2 years. Required. |
35+
| `--template string` | `` | A Go text/template string. When provided, the command output is rendered through the template instead of the default format. The template receives the command's structured response data. Example: --template '{{.Name}}' |
36+
37+
38+
## Inherited Options
39+
40+
| Flag | Default | Description |
41+
|------|---------|-------------|
42+
| `-C, --config string` | `` | The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml) |
43+
| `-D, --detailed-exitcode` | `` | Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings. |
44+
| `-O, --output-format string` | `` | Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text. |
45+
| `-P, --profile string` | `` | The name of a configuration profile to use. |
46+
| `--debug` | `` | Enable debug output for error messages, including stack traces and transaction IDs. (default false) |
47+
| `--log-file string` | `` | Write logs to a file at the given path. File logging is disabled when not set. |
48+
| `--log-file-level string` | `` | Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG) |
49+
| `--log-level string` | `` | Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN) |
50+
| `--no-color` | `` | Disable text output in color. (default false) |
51+
| `--query string` | `` | JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name' |
52+
53+
54+
## Parent Command
55+
56+
- [`pingcli pingone active-identity-counts`](cmd-pingcli-pingone-active-identity-counts.md) — Active identity counts
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# `pingcli pingone active-identity-counts`
2+
Active identity counts
3+
4+
## Synopsis
5+
6+
View active identity counts in a PingOne environment by date range
7+
8+
```
9+
pingcli pingone active-identity-counts [flags]
10+
```
11+
12+
## Examples
13+
14+
```
15+
# List active identity counts from a start date
16+
pingcli pingone active-identity-counts --environment-id <env-id> --start-date 2024-01-01T00:00:00Z
17+
18+
# List with monthly aggregation
19+
pingcli pingone active-identity-counts --environment-id <env-id> --start-date 2024-01-01T00:00:00Z --sample-period MONTH
20+
```
21+
22+
## Inherited Options
23+
24+
| Flag | Default | Description |
25+
|------|---------|-------------|
26+
| `-C, --config string` | `` | The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml) |
27+
| `-D, --detailed-exitcode` | `` | Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings. |
28+
| `-O, --output-format string` | `` | Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text. |
29+
| `-P, --profile string` | `` | The name of a configuration profile to use. |
30+
| `--debug` | `` | Enable debug output for error messages, including stack traces and transaction IDs. (default false) |
31+
| `--log-file string` | `` | Write logs to a file at the given path. File logging is disabled when not set. |
32+
| `--log-file-level string` | `` | Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG) |
33+
| `--log-level string` | `` | Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN) |
34+
| `--no-color` | `` | Disable text output in color. (default false) |
35+
| `--query string` | `` | JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name' |
36+
37+
38+
## Subcommands
39+
40+
| Command | Description | Reference |
41+
|---------|-------------|----------|
42+
| `pingcli pingone active-identity-counts list` | List active identity counts | [`cmd-pingcli-pingone-active-identity-counts-list.md`](cmd-pingcli-pingone-active-identity-counts-list.md) |
43+
44+
## Parent Command
45+
46+
- [`pingcli pingone`](cmd-pingcli-pingone.md) — Administration tools for the PingOne platform.

.agents/skills/pingcli-usage/references/cmd-pingcli-pingone-api.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,11 +43,8 @@ Send a custom API request to the configured PingOne tenant, making a GET request
4343
| `-f, --fail` | `` | Return non-zero exit code when HTTP custom API request returns a failure status code. |
4444
| `-m, --http-method string` | `` | The HTTP method to use for the request. (default GET) Options are: DELETE, GET, PATCH, POST, PUT. Example: 'POST' |
4545
| `-r, --header []string` | `` | A custom header to send in the request. Example: --header "Content-Type: application/vnd.pingidentity.user.import+json" |
46-
| `--authorization-code` | `` | Use authorization code flow |
47-
| `--client-credentials` | `` | Use client credentials flow |
4846
| `--data string` | `` | The file containing data to send in the request. Example: './data.json' |
4947
| `--data-raw string` | `` | The raw data to send in the request. Example: '{"name": "My environment"}' |
50-
| `--device-code` | `` | Use device authorization flow |
5148
| `--template string` | `` | A Go text/template string. When provided, the command output is rendered through the template instead of the default format. The template receives the command's structured response data. Example: --template '{{.Name}}' |
5249

5350

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# `pingcli pingone auth refresh`
2+
Refresh the current authenticated session.
3+
4+
## Synopsis
5+
6+
Refresh the current authenticated session.
7+
8+
```
9+
pingcli pingone auth refresh [flags]
10+
```
11+
12+
## Examples
13+
14+
```
15+
# Refresh the current PingOne session using the stored refresh token.
16+
pingcli pingone auth refresh
17+
```
18+
19+
## Inherited Options
20+
21+
| Flag | Default | Description |
22+
|------|---------|-------------|
23+
| `-C, --config string` | `` | The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml) |
24+
| `-D, --detailed-exitcode` | `` | Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings. |
25+
| `-O, --output-format string` | `` | Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text. |
26+
| `-P, --profile string` | `` | The name of a configuration profile to use. |
27+
| `--debug` | `` | Enable debug output for error messages, including stack traces and transaction IDs. (default false) |
28+
| `--log-file string` | `` | Write logs to a file at the given path. File logging is disabled when not set. |
29+
| `--log-file-level string` | `` | Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG) |
30+
| `--log-level string` | `` | Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN) |
31+
| `--no-color` | `` | Disable text output in color. (default false) |
32+
| `--query string` | `` | JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name' |
33+
| `--storage-type string` | `` | Auth token storage (default: secure_local) secure_local - Use OS keychain (default) file_system - Store tokens in ~/.pingcli/credentials none - Do not persist tokens |
34+
35+
36+
## Parent Command
37+
38+
- [`pingcli pingone auth`](cmd-pingcli-pingone-auth.md) — Authenticate Ping CLI to the PingOne management APIs.
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# `pingcli pingone custom-admin-roles apply`
2+
Create or update a custom admin role
3+
4+
## Synopsis
5+
6+
Idempotently create or update a custom admin role looked up by the "name" field in the JSON body within the supplied --environment-id. If no custom admin role with the given name exists it is created; if exactly one exists it is updated; if more than one exists the command fails.
7+
8+
```
9+
pingcli pingone custom-admin-roles apply [flags]
10+
```
11+
12+
## Examples
13+
14+
```
15+
# Create or update a custom admin role (body supplies name, permissions, and canBeAssignedBy)
16+
pingcli pingone custom-admin-roles apply --environment-id <env-id> --from-file custom_admin_role.json
17+
18+
# Read body from stdin
19+
pingcli pingone custom-admin-roles apply --environment-id <env-id> --from-file - < custom_admin_role.json
20+
```
21+
22+
## Options
23+
24+
| Flag | Default | Description |
25+
|------|---------|-------------|
26+
| `-h, --help` | `` | help for apply |
27+
| `-e, --environment-id string` | `` | The PingOne environment ID |
28+
| `-f, --from-file string` | `` | Path to a JSON file containing the request body, or "-" to read from stdin. |
29+
| `-i, --custom-admin-role-id string` | `` | The custom admin role ID |
30+
31+
32+
## Inherited Options
33+
34+
| Flag | Default | Description |
35+
|------|---------|-------------|
36+
| `-C, --config string` | `` | The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml) |
37+
| `-D, --detailed-exitcode` | `` | Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings. |
38+
| `-O, --output-format string` | `` | Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text. |
39+
| `-P, --profile string` | `` | The name of a configuration profile to use. |
40+
| `--debug` | `` | Enable debug output for error messages, including stack traces and transaction IDs. (default false) |
41+
| `--log-file string` | `` | Write logs to a file at the given path. File logging is disabled when not set. |
42+
| `--log-file-level string` | `` | Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG) |
43+
| `--log-level string` | `` | Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN) |
44+
| `--no-color` | `` | Disable text output in color. (default false) |
45+
| `--query string` | `` | JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name' |
46+
47+
48+
## Parent Command
49+
50+
- [`pingcli pingone custom-admin-roles`](cmd-pingcli-pingone-custom-admin-roles.md) — Custom Admin Roles
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# `pingcli pingone custom-admin-roles create`
2+
Create a new custom admin role
3+
4+
## Synopsis
5+
6+
Create a new custom admin role in a PingOne environment
7+
8+
```
9+
pingcli pingone custom-admin-roles create [flags]
10+
```
11+
12+
## Examples
13+
14+
```
15+
# Create a new custom admin role from a JSON file
16+
pingcli pingone custom-admin-roles create --environment-id <env-id> --from-file custom_admin_role.json
17+
18+
# Create a new custom admin role from stdin
19+
pingcli pingone custom-admin-roles create --environment-id <env-id> --from-file - < custom_admin_role.json
20+
```
21+
22+
## Options
23+
24+
| Flag | Default | Description |
25+
|------|---------|-------------|
26+
| `-h, --help` | `` | help for create |
27+
| `-e, --environment-id string` | `` | The PingOne environment ID |
28+
| `-f, --from-file string` | `` | Path to a JSON file containing the request body, or "-" to read from stdin. |
29+
30+
31+
## Inherited Options
32+
33+
| Flag | Default | Description |
34+
|------|---------|-------------|
35+
| `-C, --config string` | `` | The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml) |
36+
| `-D, --detailed-exitcode` | `` | Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings. |
37+
| `-O, --output-format string` | `` | Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text. |
38+
| `-P, --profile string` | `` | The name of a configuration profile to use. |
39+
| `--debug` | `` | Enable debug output for error messages, including stack traces and transaction IDs. (default false) |
40+
| `--log-file string` | `` | Write logs to a file at the given path. File logging is disabled when not set. |
41+
| `--log-file-level string` | `` | Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG) |
42+
| `--log-level string` | `` | Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN) |
43+
| `--no-color` | `` | Disable text output in color. (default false) |
44+
| `--query string` | `` | JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name' |
45+
46+
47+
## Parent Command
48+
49+
- [`pingcli pingone custom-admin-roles`](cmd-pingcli-pingone-custom-admin-roles.md) — Custom Admin Roles

0 commit comments

Comments
 (0)