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-list or group-get command. 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 name jf rt gdel in the usage line. Both jf rt group-delete and jf rt gdel are equivalent and interchangeable.

Arguments

ArgumentRequiredDescription
<group name>YesThe name of the group to delete

Options

FlagDefaultDescription
--access-tokenβ€”JFrog access token
--passwordβ€”JFrog password (for authentication)
--quiet$CISet 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:

  1. Run:
jf rt group-delete --help

Delete a Group (Interactive)

Running without --quiet prompts for confirmation before proceeding.

To delete a group with confirmation:

  1. Run:
jf rt group-delete <group name>

Where:

  • <group name> β€” name of the group to delete (see Arguments).

Full example:

jf rt group-delete developers

Expected 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:

  1. Run:
jf rt group-delete <group name> --quiet

Full example:

jf rt group-delete developers --quiet

On 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.
  • --quiet default: In CI environments (when CI is set), --quiet defaults to true.
  • Requires admin privileges on the Artifactory instance.
  • Permission targets that reference this group will no longer grant access through it after deletion.

Troubleshooting

ErrorCauseResolution
401 Token failed verificationThe stored access token is expired or invalidRe-authenticate with jf config add, or pass a fresh token using --access-token <token>
403 ForbiddenThe configured user does not have admin privilegesUse credentials for an account with admin rights, or contact your Artifactory administrator
404 Not FoundThe specified group does not existVerify the group name in the Artifactory UI or REST API before retrying


What’s Next

To create a replacement group, see jf rt group-create.