Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion guides/pullbasectl.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ docker compose exec central-server pullbasectl servers install-script \
</Step>
</Steps>

### Create/List Users
### Create/List/Delete Users

Manage access for your team.

Expand All @@ -162,8 +162,18 @@ docker compose exec central-server pullbasectl users create \
--new-username "auditor" \
--new-password "AuditPass123!" \
--role viewer

# Delete a user's account
docker compose exec central-server pullbasectl users delete \
--server-url http://localhost:8080 \
--user-id 7 \
--delete-acct-username "SomeAccount123"
```

<Tip>
User deletion is blocked if you attempt to delete the last active admin or your own account.
</Tip>

### Validate Config Locally

Validate your `config.yaml` before pushing to Git to prevent errors.
Expand Down
25 changes: 22 additions & 3 deletions reference/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -729,9 +729,28 @@ pullbasectl users list \
--limit 50
```

<Info>
User deletion currently requires the web UI or the REST API (`DELETE /api/v1/users/{userID}`). CLI support is planned.
</Info>
### `pullbasectl users delete`

Delete a user account.

<ParamField flag="--user-id" type="integer" required>
ID of the user to delete.
</ParamField>
<ParamField flag="--delete-acct-username" type="string" required>
Username of the account to delete (used as confirmation).
</ParamField>

<Note>
Deletion is blocked if you attempt to delete the last active admin or your own account. The `--delete-acct-username` flag serves as confirmation and must match the username associated with the user ID.
</Note>

```bash
pullbasectl users delete \
--server-url http://localhost:8080 \
--admin-token $ADMIN_JWT \
--user-id 7 \
--delete-acct-username "SomeAccount123"
```

## Bootstrap wizard (interactive)

Expand Down