Delete an Artifactory group with jf rt group-delete
Delete a users group from Artifactory.
Prerequisites
- JFrog CLI installed and configured (
jf config add) - Admin privileges on the Artifactory instance
- The group to be deleted must already exist
Note
The JFrog CLI does not provide a
group-listorgroup-getcommand. Before deleting, verify the exact group name in the Artifactory UI (Administration β Identity and Access β Groups) or via the Artifactory REST API (GET /access/api/v2/groups). Deleting a group is irreversible β a typo in the group name cannot be undone.
Synopsis
jf rt group-delete <group name> [options]
Aliases: rt gdel
Note
When you run
jf rt group-delete --help, the CLI displays the alias namejf rt gdelin the usage line. Bothjf rt group-deleteandjf rt gdelare equivalent and interchangeable.
Arguments
| Argument | Required | Description |
|---|---|---|
<group name> | Yes | The name of the group to delete |
Options
| Flag | Default | Description |
|---|---|---|
--access-token | β | JFrog access token |
--password | β | JFrog password (for authentication) |
--quiet | $CI | Set to true to skip the delete confirmation message |
--server-id | β | Server ID configured using the jf config command |
--ssh-key-path | β | SSH key file path |
--ssh-passphrase | β | SSH key passphrase |
--url | β | JFrog Artifactory URL (example: https://acme.jfrog.io/artifactory) |
--user | β | JFrog username |
Examples
Verify Command Help
To view command help:
- Run:
jf rt group-delete --helpDelete a Group (Interactive)
Running without --quiet prompts for confirmation before proceeding.
To delete a group with confirmation:
- Run:
jf rt group-delete <group name>Where:
<group name>β name of the group to delete (see Arguments).
Full example:
jf rt group-delete developersExpected output:
Delete the group developers? (y/n): y
Done deleting group: developers.
Warning
This action permanently removes the group. You cannot undo it.
Delete a Group (Non-Interactive)
Use --quiet to skip the confirmation prompt. Suitable for CI pipelines where the CI environment variable is set.
To delete a group without a prompt:
- Run:
jf rt group-delete <group name> --quietFull example:
jf rt group-delete developers --quietOn success the command exits with code 0 and produces no output. The absence of output is expected β it does not indicate a problem.
Note
The CLI prints a
[Info] Trace ID for JFrog Platform logs: <id>line on every server request. This is informational and can be used to correlate requests in JFrog Platform logs. It does not indicate an error.
Important Notes
- Irreversible: Deleting a group removes it permanently. Users who were members lose the group's permissions immediately.
- Deleting a group does not delete its member users β they remain in Artifactory but lose permissions granted through this group.
--quietdefault: In CI environments (whenCIis set),--quietdefaults totrue.- Requires admin privileges on the Artifactory instance.
- Permission targets that reference this group will no longer grant access through it after deletion.
Troubleshooting
| Error | Cause | Resolution |
|---|---|---|
401 Token failed verification | The stored access token is expired or invalid | Re-authenticate with jf config add, or pass a fresh token using --access-token <token> |
403 Forbidden | The configured user does not have admin privileges | Use credentials for an account with admin rights, or contact your Artifactory administrator |
404 Not Found | The specified group does not exist | Verify the group name in the Artifactory UI or REST API before retrying |
Updated about 1 month ago
