Parseable
pb CLI

Users and Roles

Copy page as Markdown
View page source on GitHub
Ask OpenAI about this page
Ask Claude about this page

These commands require admin privileges on the Parseable server.

Parseable uses role-based access control. In practice, that means you define roles first, then assign those roles to users.

Roles

Create a role

pb role add <name>

This opens an interactive prompt where you choose the privilege level and the dataset scope.

Privilege levels:

PrivilegeAccess
noneNo server privileges
adminFull system-wide access
editorRead and write access across datasets
readerRead-only access to a specific dataset
writerRead and write access to a specific dataset
ingestorWrite-only (ingest) access to a specific dataset
pb role add log-readers

List roles

pb role list
pb role list --output json

Delete a role

pb role remove <name>
pb role rm <name>

Users

Create a user

pb user add <username>

The server generates a password and prints it once. Keep it somewhere safe because it cannot be retrieved later.

Assign roles at creation time:

pb user add bob --role log-readers,developers

List users

pb user list
pb user list --output json

Update user roles

pb user set-role <username> <roles>
pb user set-role bob log-readers,admins

Delete a user

pb user remove <username>
pb user rm <username>

Roles must exist before they can be assigned to a user. Create roles with pb role add first.

Was this page helpful?

On this page