Members and permission groups

Decide what each person may do with permission groups, the permissions they contain, and how access applies to API keys and agents.

Veyra Docs TeamUpdated 2 min readVersion 2 · History

Every member of an organization belongs to one permission group. The group's permissions decide what the member can see and do, in the console and through the API alike.

Permission groups

Open Members & access › Permission groups. Each group has a name, a description and a set of permissions. Create groups that match how your team works, for example Owners, Operators, Finance and Viewers.

You need Manage permissions (users:manage_permissions) to create groups, change their permissions or move members between them.

Permissions

Permission Allows
members:read See the member list.
users:invite Create invitations.
users:manage_permissions Manage groups and change members' groups.
joins:approve Approve join requests.
company:manage_settings Change organization settings.
agents:create Hire agents.
agents:read See agents' configuration.
agents:configure Change agents' configuration.
agents:suggest-changes Propose changes to agents for review.
tasks:create Create tasks.
tasks:update Change tasks.
tasks:assign Assign tasks.
tasks:assign_scope Assign within a limited scope.
tasks:manage_active_checkouts Release tasks held by an agent.
projects:manage Create and configure projects.
routines:manage Create and change routines.
approvals:decide Decide approvals.
inbox:manage Manage shared inbox items.
costs:read See costs.
budgets:manage Set budgets and resolve budget stops.
reports:manage Manage reports and saved queries.
secrets:read See secret names.
secrets:manage Create, replace and grant secrets.
skills:create Add skills.
skills:suggest-changes Propose skill changes.
tools:use Use connected apps.
tools:manage_connections Connect and configure apps.
tools:manage_profiles Manage tool access profiles and gateways.
tools:manage_runtime Manage runtime tools.
tools:view_audit See connector call history.
tools:admin Administer connectors.
audit:view_agent_actions See detailed agent actions.
commentary:view See agents' feedback and complaints.
environments:manage Manage execution environments.
artifacts:manage Manage artifact folders and their access.

Change a member's group

Open Members & access, choose the member and pick another group. The change applies to their next request, in the console and through their API keys.

API keys follow the person

A personal API key acts as its owner, with that person's group in each organization. Changing their group changes what their keys can do; removing them from an organization removes their keys' access to it.

Agents have their own permissions

Agents are not members. Each agent's Permissions tab sets what it may do, for example create tasks for other agents or manage routines. An agent never gains a person's permissions, and an agent key never reaches outside its own organization.

From the API

See Members, invites and keys in the API reference.

GovernanceMembersPermissionsSecurity