> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles & Permissions

> What each organization role can do on the Galtea platform

> [!WARNING]
>
> You are reading the docs of Galtea 5.10. [Read this page in the latest version](https://docs.galtea.ai/security/roles-and-permissions.md).

Galtea uses role-based access control. Every member of your organization has one role that decides what they can see and change. This page lists the four organization roles and the actions each one can perform. Actions cover the standard operations (Create, Read, Update, Delete) plus a soft delete (a logical delete that hides a record without removing it). Many permissions are conditional, shown as a short rule in the cell.

## Roles

* **OWNER**: Manages users and resources in their own organization. Can permanently delete only Sessions and User Groups; every other entity is soft delete at most. Only OWNER may create, edit, or delete a User Group, or change its users or products.
* **MEMBER**: Day-to-day access in their organization: view and contribute, with limited edits. Can permanently delete only Sessions; every other entity is soft delete at most. Reads every User Group of the organization. Cannot create, edit, or delete a User Group, or change its users or products. May link or unlink a group of the organization to a metric it may edit.
* **HUMAN\_EVALUATOR**: Read-only on the products their user groups grant, plus may annotate AI metrics and submit human evaluations on them. Can also update their own account settings (name, consents and MFA method).
* **READER**: Read-only on the products their user groups grant. Cannot create, update, or delete anything except their own account settings (name, consents and MFA method).

> [!NOTE]
>
> Each cell shows what a role can do for that action. ✅ means allowed and ❌ means not allowed. A short rule (for example, "If product in own org") means the action is allowed only when that rule is true at the time, checked against your organization and the record's ownership.

## Permissions by area

### Identity & Organization

**User**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If target in own org | ❌ | ❌ | ❌ |
| Read | If target in own org | If target in own org | If target in own org | If target in own org |
| Update | If target in own org | Only self | Only self | Only self |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If target in own org, not self, and not an admin | ❌ | ❌ | ❌ |
| Self delete | Only self | Only self | Only self | Only self |

**Organization**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | ❌ | ❌ | ❌ | ❌ |
| Read | Own org | Own org | Own org | Own org |
| Update | Own org, some fields only | ❌ | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | ❌ | ❌ | ❌ | ❌ |

*An OWNER may update only the credit warning threshold, MFA enforcement, the SAML SSO settings, and the OpenTelemetry settings. An OWNER cannot change the organization name.*

**Subscription**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | ❌ | ❌ | ❌ | ❌ |
| Read | Own org | Own org | Own org | Own org |
| Update | If subscription in own org and billed through Stripe | If subscription in own org and billed through Stripe | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | ❌ | ❌ | ❌ | ❌ |

**User Group**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If group in own org | ❌ | ❌ | ❌ |
| Read | If group in own org | If group in own org | If group in own org | If group in own org |
| Update | If group in own org | ❌ | ❌ | ❌ |
| Delete | If group in own org | ❌ | ❌ | ❌ |
| Soft delete | If group in own org | ❌ | ❌ | ❌ |

### Test Assets

**Product**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If product in own org | If product in own org | ❌ | ❌ |
| Read | If product in own org | If product in own org | If product is granted by one of their user groups | If product is granted by one of their user groups |
| Update | If product in own org | If product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If product in own org | If product is theirs (by userId) | ❌ | ❌ |
| See the Tutorial entry | If product in own org | If product in own org | ❌ | ❌ |
| See the Configuration entry | If product in own org | If product in own org | ❌ | ❌ |

*The Tutorial and Configuration entry rows only control what the dashboard shows for this product (the sidebar entry, its page and its list URL): the API still returns this data to every role that can read the product.*

**Version**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Read | If parent product in own org | If parent product in own org | If parent product is granted by one of their user groups | If parent product is granted by one of their user groups |
| Update | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If parent product in own org | If parent product in own org | ❌ | ❌ |
| See the Versions entry | If parent product in own org | If parent product in own org | ❌ | ❌ |

*The Versions entry row only controls what the dashboard shows for this product (the sidebar entry, its page and its list URL): the API still returns versions to every role that can read them.*

**Dataset**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Read | If parent product in own org, or dataset is global | If parent product in own org, or dataset is global | If parent product is granted by one of their user groups, or dataset is global | If parent product is granted by one of their user groups, or dataset is global |
| Update | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If parent product in own org | If parent product in own org | ❌ | ❌ |
| See the Datasets entry | If parent product in own org | If parent product in own org | ❌ | ❌ |

*The Datasets entry row only controls what the dashboard shows for this product (the sidebar entry, its page and its list URL): the API still returns datasets to every role that can read them.*

**Test Case**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If parent dataset in own org | If parent dataset in own org | ❌ | ❌ |
| Read | If parent dataset in own org, or dataset is global | If parent dataset in own org, or dataset is global | If parent dataset's product is granted by one of their user groups, or dataset is global | If parent dataset's product is granted by one of their user groups, or dataset is global |
| Update | If parent dataset in own org | If parent dataset in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If parent dataset in own org | If parent dataset in own org | ❌ | ❌ |

**Specification**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Read | If parent product in own org | If parent product in own org | If parent product is granted by one of their user groups | If parent product is granted by one of their user groups |
| Update | If parent product in own org | If parent product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If parent product in own org | If parent product in own org | ❌ | ❌ |

### Connections

**Endpoint Connection**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Read | If connection's product in own org | If connection's product in own org | If connection's product is granted by one of their user groups | If connection's product is granted by one of their user groups |
| Update | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If connection's product in own org | If connection's product in own org | ❌ | ❌ |

**Phone Connection**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Read | If connection's product in own org | If connection's product in own org | If connection's product is granted by one of their user groups | If connection's product is granted by one of their user groups |
| Update | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If connection's product in own org | If connection's product in own org | ❌ | ❌ |

**WebRTC Connection**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Read | If connection's product in own org | If connection's product in own org | If connection's product is granted by one of their user groups | If connection's product is granted by one of their user groups |
| Update | If connection's product in own org | If connection's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If connection's product in own org | If connection's product in own org | ❌ | ❌ |

### Evaluation & Results

**Session**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If session's product in own org | If session's product in own org | ❌ | ❌ |
| Read | If session's product in own org | If session's product in own org | If session's product is granted by one of their user groups | If session's product is granted by one of their user groups |
| Update | If session's product in own org | If session's product in own org | ❌ | ❌ |
| Delete | If session's product in own org | If session's product in own org | ❌ | ❌ |
| Soft delete | If session's product in own org | If session's product in own org | ❌ | ❌ |

**Evaluation**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If evaluation's product in own org | If evaluation's product in own org | ❌ | ❌ |
| Read | If evaluation's product in own org | If evaluation's product in own org | If evaluation's product is granted by one of their user groups | If evaluation's product is granted by one of their user groups |
| Update | If evaluation's product in own org | If evaluation's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If evaluation's product in own org | If evaluation's product in own org | ❌ | ❌ |
| Annotate AI metric (add, edit, or remove) | If evaluation's product in own org | If evaluation's product in own org | If evaluation's product is granted by one of their user groups | ❌ |
| Human evaluation | If evaluation's product in own org | If evaluation's product in own org | If evaluation's product is granted by one of their user groups | ❌ |
| See evaluation metadata | If evaluation's product in own org | If evaluation's product in own org | If evaluation's product is granted by one of their user groups | ❌ |
| See inference metrics and judge cost | If evaluation's product in own org | If evaluation's product in own org | If evaluation's product is granted by one of their user groups | ❌ |

*Human evaluation also requires membership in a User Group linked to the metric. A HUMAN\_EVALUATION metric with no linked group reaches nobody. Annotating an AI metric has no group check. One gate covers the whole annotation, so anyone who may annotate may also edit or remove an annotation another person wrote. The table shows the role-level gate only. The evaluation metadata and inference metrics rows only control what the dashboard shows: the API still returns this data to every role that can read the evaluation, which for a READER or HUMAN\_EVALUATOR means only on the products their user groups grant. The metadata row covers the evaluation page. The inference metrics row covers the judge tokens and judge credits of every evaluation list, the inference metrics of the evaluation, session and version pages, and the metrics tab of the Trace card. Span latency (Spans tab, trace page) and the Analytics version summary (latency, tokens and cost) stay visible.*

**Trace**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If trace's product in own org | If trace's product in own org | ❌ | ❌ |
| Read | If trace's product in own org | If trace's product in own org | If trace's product is granted by one of their user groups | If trace's product is granted by one of their user groups |
| Update | If trace's product in own org | If trace's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If trace's product in own org | If trace's product in own org | ❌ | ❌ |

**Span**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If span's product in own org | If span's product in own org | ❌ | ❌ |
| Read | If span's product in own org | If span's product in own org | If span's product is granted by one of their user groups | If span's product is granted by one of their user groups |
| Update | If span's product in own org | If span's product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If span's product in own org | If span's product in own org | ❌ | ❌ |

**Comment**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | ✅ | ✅ | ❌ | ❌ |
| Read | ✅ | ✅ | ✅ | ✅ |
| Delete | ✅ | If the comment's author | ❌ | ❌ |

*Free-form reviewer text on a trace. Access also requires the parent trace to be in your organization. Deleting is a soft delete; you may delete your own comments, and organization owners may delete any.*

**Monitor**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If product in own org | If product in own org | ❌ | ❌ |
| Read | If product in own org | If product in own org | If parent product is granted by one of their user groups | If parent product is granted by one of their user groups |
| Update | If product in own org | If product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If product in own org | If product in own org | ❌ | ❌ |

**Run**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If product in own org | If product in own org | ❌ | ❌ |
| Read | If product in own org | If product in own org | If parent product is granted by one of their user groups | If parent product is granted by one of their user groups |
| Update | If product in own org | If product in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If product in own org | If product in own org | ❌ | ❌ |

### Reference Data

**Metric**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If metric in own org | If metric in own org | ❌ | ❌ |
| Read | If in own org, or global | If in own org, or global | If in own org, or global, and a product granted by one of their user groups uses it (any such metric with an all-products group) | If in own org, or global, and a product granted by one of their user groups uses it (any such metric with an all-products group) |
| Update | If metric in own org | If metric in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If metric in own org | If metric in own org | ❌ | ❌ |

**Model**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Create | If model in own org | If model in own org | ❌ | ❌ |
| Read | If in own org, or global | If in own org, or global | If in own org, or global | If in own org, or global |
| Update | If model in own org | If model in own org | ❌ | ❌ |
| Delete | ❌ | ❌ | ❌ | ❌ |
| Soft delete | If model in own org | If model in own org | ❌ | ❌ |

### Analytics & Insights

**Analytics**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Read | If data in own org | If data in own org | If product is granted by one of their user groups | If product is granted by one of their user groups |
| See the Coverage section | If data in own org | If data in own org | ❌ | ❌ |
| See the Scores comparison section | If data in own org | If data in own org | ❌ | ❌ |
| See the Inference section | If data in own org | If data in own org | ❌ | ❌ |

*The Coverage, Scores comparison, and Inference rows only control what the dashboard shows on the Analytics page: the API still returns this data to every role that can read Analytics, and to a READER or HUMAN\_EVALUATOR only for the products their user groups grant.*

### Dashboard

**Dashboard views**

| Action | OWNER | MEMBER | HUMAN\_EVALUATOR | READER |
| - | - | - | - | - |
| Update the organization settings | ✅ | ❌ | ❌ | ❌ |
| Create organization users | ✅ | ❌ | ❌ | ❌ |
| Manage user groups | ✅ | ❌ | ❌ | ❌ |
| See Human Evaluations | ✅ | ✅ | ✅ | ❌ |

*These rows decide what the dashboard shows or hides for a role. They do not grant access: the platform still checks the permission behind each action.*

## Notes

* **Read-only roles**: READER and HUMAN\_EVALUATOR read what a MEMBER reads, except that products and everything inside a product are limited to the products granted by their user groups, and metrics to the ones those products use (all of them for a group linked to all products); the dashboard also hides three Analytics sections, and the Datasets, Versions, Tutorial and Configuration entries of the product sidebar, from them. When their user groups grant exactly one product, sign-in opens that product's Analytics instead of the product list. They cannot create, update, or delete, except their own account settings (name, consents and MFA method). HUMAN\_EVALUATOR additionally may annotate AI metrics and submit human evaluations, on those products only; READER cannot. The dashboard also hides from READER the evaluation metadata on an evaluation page, and the judge tokens and judge credits of every evaluation list, the inference metrics of the evaluation, session and version pages, and the metrics tab of the Trace card. Span latency and the Analytics version summary (latency, tokens and cost) stay visible.
* **Product access**: A READER or HUMAN\_EVALUATOR sees a product only when one of their user groups links it. A user group with the all-products setting grants every product of the organization, current and future. A user in no group sees no product. Records with no product, such as a global dataset, stay readable. When read by id, a product outside the granted set answers like a record of another organization. On the dataset list, naming an ungranted product answers 403, and naming another organization's product returns no dataset. In a user group, their `product_ids` list only the granted products. Metrics follow the products: unless one of their groups links all products, a metric is visible only when a granted product evaluates it, links it to a specification, or monitors it, and every revision of that metric is visible then. Any other metric answers like a metric of another organization. A metric's `specification_ids` list only the specifications of granted products, and a user group's `metric_ids` only the visible metrics. OWNER and MEMBER are not limited this way.
* **Organization scope**: "In own org" means the record (or its parent, such as a Product) has an organizationId equal to the signed-in user's organization. This keeps each client organization's data separate.
* **Parent scope**: For nested records (Version, Dataset, Evaluation, and so on) access is derived from the parent's organization. Example: a Version belongs to a Product, and the Product belongs to an Organization. An Evaluation is reached through session to version to product.
* **Global records**: Some records (Metric, Model, and a Dataset with no product) can be global, meaning not tied to one organization. Global records are readable by every role in addition to their own organization's records, except that a READER or HUMAN\_EVALUATOR in no all-products group sees a global metric only when a granted product uses it.
* **Hard delete**: Each entity table has two delete rows. **Soft delete** hides a record without removing it. **Delete** is a permanent removal, shown as allowed for Session (OWNER and MEMBER, within their own organization) and for User Group (OWNER only, within their own organization); for every other entity it is denied to all roles listed here.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.