# 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](/concepts/identity-and-access) for how roles and inheritance work, or call [`ListRoles`](/reference/api/roles/list-roles) for each role's full permission list.

## Basic roles [#basic-roles]

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

| Role       | ID             | What it grants                                                                                         |
| ---------- | -------------- | ------------------------------------------------------------------------------------------------------ |
| **Owner**  | `roles/owner`  | Full access to resources, access control (IAM policies), billing, policies and audit logs              |
| **Editor** | `roles/editor` | Create, update and delete most resources without managing IAM policies, members, billing or audit logs |
| **Viewer** | `roles/viewer` | Read-only access to resources and IAM policies (excludes secret values, billing and audit logs)        |

## Agents [#agents]

| Role             | ID                         | Can be granted on               | What it grants                                                                                     |
| ---------------- | -------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Agents Admin** | `roles/agents.admin`       | Organizations, projects, agents | Manage and use every agent (including private agents) and read governing policies                  |
| **Agents User**  | `roles/agents.user`        | Organizations, projects, agents | Start agents, write to and rename agents, see project agents, usage, available models and policies |
| **Agent Writer** | `roles/agents.agentWriter` | Organizations, projects, agents | See an agent, write to it and rename it                                                            |
| **Agent Viewer** | `roles/agents.agentViewer` | Organizations, projects, agents | See an agent, its transcript and who can see it                                                    |

## Environments [#environments]

| Role                   | ID                          | Can be granted on       | What it grants                                                                                                                                |
| ---------------------- | --------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Environment Admin**  | `roles/environments.admin`  | Organizations, projects | Create, update, start, stop and delete environments, registries and prepared images; sharing registries or organization images requires Owner |
| **Environment User**   | `roles/environments.user`   | Organizations, projects | Create, update, start and stop environments, request registries and see environments, registries, images, policies and quotas                 |
| **Environment Viewer** | `roles/environments.viewer` | Organizations, projects | See environments, registries, registry requests, prepared images and policies                                                                 |

## LLM Gateway [#llm-gateway]

| Role                  | ID                       | Can be granted on       | What it grants                                                                                            |
| --------------------- | ------------------------ | ----------------------- | --------------------------------------------------------------------------------------------------------- |
| **LLM Gateway Admin** | `roles/llmgateway.admin` | Organizations, projects | Manage providers, models, sharing and gateway settings; see usage, request logs, rate quotas and policies |
| **LLM Gateway User**  | `roles/llmgateway.user`  | Organizations, projects | Call project models and see models, usage, request logs, settings, rate quotas and policies               |

## Secrets and connections [#secrets-and-connections]

| Role                        | ID                             | Can be granted on                                     | What it grants                                                                              |
| --------------------------- | ------------------------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Secret Manager Admin**    | `roles/secrets.admin`          | Organizations, projects, secrets                      | Manage secrets and versions, read values, share secrets and set access                      |
| **Secret Accessor**         | `roles/secrets.secretAccessor` | Organizations, projects, secrets                      | Read secret values and grant secrets to agents                                              |
| **Secret Manager Viewer**   | `roles/secrets.viewer`         | Organizations, projects, secrets                      | See secrets, versions and who has access, never secret values                               |
| **Connection Admin**        | `roles/connections.admin`      | Organizations, projects, connections, access profiles | Create, update, verify, share and delete connections and access profiles, and manage access |
| **Connection User**         | `roles/connections.user`       | Organizations, projects, connections                  | Use a connection to create access profiles without changing the connection                  |
| **Access Profile Accessor** | `roles/connections.accessor`   | Organizations, projects, access profiles              | Issue short-lived credentials from access profiles and grant them to agents                 |
| **Connection Viewer**       | `roles/connections.viewer`     | Organizations, projects, connections, access profiles | See connections, access profiles and who has access, never issue credentials                |

## Sites [#sites]

| Role             | ID                   | Can be granted on              | What it grants                                                                            |
| ---------------- | -------------------- | ------------------------------ | ----------------------------------------------------------------------------------------- |
| **Sites Admin**  | `roles/sites.admin`  | Organizations, projects, sites | See, open, rename, share, delete sites, toggle public visibility and switch live versions |
| **Sites Viewer** | `roles/sites.viewer` | Organizations, projects, sites | See and open sites and view their version history and access                              |

## Access and projects [#access-and-projects]

| Role                          | ID                                      | Can be granted on                         | What it grants                                               |
| ----------------------------- | --------------------------------------- | ----------------------------------------- | ------------------------------------------------------------ |
| **Project Creator**           | `roles/resourcemanager.projectCreator`  | Organizations                             | Create new projects in the organization                      |
| **Member Admin**              | `roles/identity.memberAdmin`            | Organizations                             | Invite and remove people and manage organization groups      |
| **Service Account Admin**     | `roles/identity.serviceAccountAdmin`    | Organizations, projects, service accounts | Create and manage service accounts without creating API keys |
| **Service Account Key Admin** | `roles/identity.serviceAccountKeyAdmin` | Organizations, projects, service accounts | Create and delete API keys for service accounts              |

## Policies [#policies]

| Role             | ID                     | Can be granted on       | What it grants                                                                        |
| ---------------- | ---------------------- | ----------------------- | ------------------------------------------------------------------------------------- |
| **Policy Admin** | `roles/policies.admin` | Organizations, projects | Set and unset organization and project policies (requires Team or Enterprise to edit) |

## Billing [#billing]

| Role               | ID                     | Can be granted on | What it grants                                                                       |
| ------------------ | ---------------------- | ----------------- | ------------------------------------------------------------------------------------ |
| **Billing Admin**  | `roles/billing.admin`  | Organizations     | Manage plans, credits, auto-reload, usage limits, quotas and quota increase requests |
| **Billing Viewer** | `roles/billing.viewer` | Organizations     | View billing overview, costs, purchases, credits, quotas and increase requests       |

## Audit logs [#audit-logs]

| Role                   | ID                             | Can be granted on       | What it grants                                                                 |
| ---------------------- | ------------------------------ | ----------------------- | ------------------------------------------------------------------------------ |
| **Audit Log Admin**    | `roles/auditlog.admin`         | Organizations, projects | Read all audit logs (including Data Access) and configure Data Access settings |
| **Private Log Viewer** | `roles/auditlog.privateViewer` | Organizations, projects | Read Admin Activity, System Events and Data Access audit logs                  |
| **Audit Log Viewer**   | `roles/auditlog.viewer`        | Organizations, projects | Read Admin Activity and System Events audit logs                               |

## Related [#related]

- [Identity and access](/concepts/identity-and-access)
- [Invite people to an organization](/guides/access/invite-people)
