Skip to main content

What Are Roles?

Roles control what members can see and do within your Velatir account. Velatir uses two layers of roles. Organisation roles govern your entire account. Workspace roles control access within individual workspaces. Every member receives an organisation role when invited. They then receive a workspace role for each workspace they are assigned to.

Organisation Roles

Organisation roles determine what a member can do across your entire Velatir account.
RoleDescriptionKey Permissions
AdministratorFull control over the organisationManage settings, billing, members, and all workspaces. Create and delete workspaces. Invite and remove members.
ReaderView-only access to the organisationView organisation settings and member lists. Cannot make changes or manage workspaces.
Administrators handle day-to-day account management. Readers are suited for stakeholders who need visibility without the ability to make changes.

Workspace Roles

Workspace roles determine what a member can do within a specific workspace. A member can hold different roles in different workspaces.
RoleDescriptionKey Permissions
AdminFull control over the workspaceManage workspace settings, API keys, agents, and members. Full access to traces and review tasks.
EditorManage traces and review tasksView and manage traces. Create, assign, and resolve review tasks. Cannot change workspace settings or API keys.
ModeratorHandle review tasksView traces. Pick up, review, and resolve review tasks assigned to them. Cannot manage traces or settings.
ReaderView-only access to the workspaceView traces and review task outcomes. Cannot take any actions or make changes.

Choosing the Right Roles

Assign the Editor role so they can review traces and manage review tasks across the workspace. If they only need to observe, Reader works.
Workspace Admin gives them full control to configure agents, manage API keys, and oversee their team’s workspace.
Moderator is designed for people whose primary job is handling review tasks. They see what they need and nothing more.
Organisation Reader plus workspace Reader gives them visibility across the board without any risk of accidental changes.

Inviting Members

Open Member Settings

Navigate to your organisation settings and select the Members section.

Send an Invitation

Enter the new member’s email address and select their organisation role. They receive an email invitation to join.

Assign to Workspaces

Once they accept the invitation, assign them to one or more workspaces and choose a workspace role for each.
You can update roles at any time. Removing a member from a workspace revokes their access immediately.

Organisations & Workspaces

Learn how organisations and workspaces are structured

Data Privacy

Understand how Velatir handles data privacy and access control