How do I update or delete a group?

Steps

1. Your role needs group:update for edits, or group:delete for removal. Both show on the API Reference rows.
2. Call GET /api/groups with your Bearer token, which lists each group with its member profiles. Copy the id of the one you want.
3. To change a group, send PUT /api/groups/:id. Include the name, the description and the full membership you want it to hold, whether chosen by tag, by explicit profiles or by both, because the call replaces what was there before.
4. To remove a group, send DELETE /api/groups/:id.
5. Go to Groups in the sidebar and reload the page. The list should match what you sent, with the right name, description and member count.

The Groups page we reviewed was empty, so we did not see edit or delete controls on a row. If your page shows them, they do the same job. Use whichever you prefer.

Good to know

Groups scope access, so a change here can alter what other people can reach. A token carries its owner's group scope. Remove a group that gave someone access to a profile, and their next call or CI job can start to fail without any other warning.

• The call descriptions do not say that deleting a group deletes its profiles. Check the profile list afterwards.
• If a pipeline fails after a change, read why CI cannot access a profile.
• New group? See how to create one.

Keep groups tight, in line with least privilege.

Related questions

• How do I create a group of scan profiles?
• How do I add all profiles with a certain tag to a group?
• What are groups used for?
• Can I give someone access to only some of our targets?
• How do I delete a tag?

Full tutorial

How to group scan profiles by tag and group in Cyberlop

Step-by-step, with annotated screenshots.

Updated 8 October 2026 · Back to the help centre