Skip to Content
kosemdocs
Reference

Roles

Every predefined role in kosem, its API ID, where it can be granted, and what it lets people and service accounts do.

Every predefined role in kosem, grouped by product. Roles granted on an organization apply to all of its projects; roles granted on a project or resource apply only there. See Identity and access for how roles and inheritance work, or call ListRoles for each role's full permission list.

Basic roles

Basic roles can be granted on organizations, projects, service accounts, connections, access profiles, secrets, agents and sites.

RoleIDWhat it grants
Ownerroles/ownerFull access to resources, access control (IAM policies), billing, policies and audit logs
Editorroles/editorCreate, update and delete most resources without managing IAM policies, members, billing or audit logs
Viewerroles/viewerRead-only access to resources and IAM policies (excludes secret values, billing and audit logs)

Agents

RoleIDCan be granted onWhat it grants
Agents Adminroles/agents.adminOrganizations, projects, agentsManage and use every agent (including private agents) and read governing policies
Agents Userroles/agents.userOrganizations, projects, agentsStart agents, write to and rename agents, see project agents, usage, available models and policies
Agent Writerroles/agents.agentWriterOrganizations, projects, agentsSee an agent, write to it and rename it
Agent Viewerroles/agents.agentViewerOrganizations, projects, agentsSee an agent, its transcript and who can see it

Environments

RoleIDCan be granted onWhat it grants
Environment Adminroles/environments.adminOrganizations, projectsCreate, update, start, stop and delete environments, registries and prepared images; sharing registries or organization images requires Owner
Environment Userroles/environments.userOrganizations, projectsCreate, update, start and stop environments, request registries and see environments, registries, images, policies and quotas
Environment Viewerroles/environments.viewerOrganizations, projectsSee environments, registries, registry requests, prepared images and policies

LLM Gateway

RoleIDCan be granted onWhat it grants
LLM Gateway Adminroles/llmgateway.adminOrganizations, projectsManage providers, models, sharing and gateway settings; see usage, request logs, rate quotas and policies
LLM Gateway Userroles/llmgateway.userOrganizations, projectsCall project models and see models, usage, request logs, settings, rate quotas and policies

Secrets and connections

RoleIDCan be granted onWhat it grants
Secret Manager Adminroles/secrets.adminOrganizations, projects, secretsManage secrets and versions, read values, share secrets and set access
Secret Accessorroles/secrets.secretAccessorOrganizations, projects, secretsRead secret values and grant secrets to agents
Secret Manager Viewerroles/secrets.viewerOrganizations, projects, secretsSee secrets, versions and who has access, never secret values
Connection Adminroles/connections.adminOrganizations, projects, connections, access profilesCreate, update, verify, share and delete connections and access profiles, and manage access
Connection Userroles/connections.userOrganizations, projects, connectionsUse a connection to create access profiles without changing the connection
Access Profile Accessorroles/connections.accessorOrganizations, projects, access profilesIssue short-lived credentials from access profiles and grant them to agents
Connection Viewerroles/connections.viewerOrganizations, projects, connections, access profilesSee connections, access profiles and who has access, never issue credentials

Sites

RoleIDCan be granted onWhat it grants
Sites Adminroles/sites.adminOrganizations, projects, sitesSee, open, rename, share, delete sites, toggle public visibility and switch live versions
Sites Viewerroles/sites.viewerOrganizations, projects, sitesSee and open sites and view their version history and access

Access and projects

RoleIDCan be granted onWhat it grants
Project Creatorroles/resourcemanager.projectCreatorOrganizationsCreate new projects in the organization
Member Adminroles/identity.memberAdminOrganizationsInvite and remove people and manage organization groups
Service Account Adminroles/identity.serviceAccountAdminOrganizations, projects, service accountsCreate and manage service accounts without creating API keys
Service Account Key Adminroles/identity.serviceAccountKeyAdminOrganizations, projects, service accountsCreate and delete API keys for service accounts

Policies

RoleIDCan be granted onWhat it grants
Policy Adminroles/policies.adminOrganizations, projectsSet and unset organization and project policies (requires Team or Enterprise to edit)

Billing

RoleIDCan be granted onWhat it grants
Billing Adminroles/billing.adminOrganizationsManage plans, credits, auto-reload, usage limits, quotas and quota increase requests
Billing Viewerroles/billing.viewerOrganizationsView billing overview, costs, purchases, credits, quotas and increase requests

Audit logs

RoleIDCan be granted onWhat it grants
Audit Log Adminroles/auditlog.adminOrganizations, projectsRead all audit logs (including Data Access) and configure Data Access settings
Private Log Viewerroles/auditlog.privateViewerOrganizations, projectsRead Admin Activity, System Events and Data Access audit logs
Audit Log Viewerroles/auditlog.viewerOrganizations, projectsRead Admin Activity and System Events audit logs

On this page