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

# Permissions

> See and change which teams, people and agents can reach which datasets, in one place.

The **Permissions** page is the one place to decide who can reach which memory: your agents, your teammates and other teams. Open it from **Permissions** in the **Connect** section of the sidebar (route `/memory-permissions`). It replaces the old Members page: the **Members** link in the profile menu now opens [Teams and people](#teams-and-people) on this page.

The page reads top to bottom, and each part is drawn for your role. For the model behind it (teams, owning teams, agents and promotion), see [Permissions and memory promotion](https://docs.cognee.ai/cognee-cloud/functionality/memory-permissions.md).

## What you see by role

| Role | What the page gives you |
| - | - |
| **Workspace admin** (the person who created the workspace, shown as **Owner** in the members list) | Everything: **Manage access**, all four **Quick actions**, the whole **Team matrix**, **Sharing**, and every team in **Teams and people**. Only the workspace admin creates and deletes teams and names organisation admins. |
| **Organisation admin** | The same as the workspace admin, except creating or deleting teams and naming organisation admins. |
| **Team admin** (team lead) | What a member gets, plus **Add people to your team** and the datasets your team owns: who else gets them and at which level. |
| **Member** | **Check your access**, your own **Your requests**, the **You** and **Your team** view of the matrix, and the teams you are in. |

An agent acts for the person who owns it and administers nothing.

## Manage access

Workspace and organisation admins get a single field: ask a question or give or remove access in one sentence (up to 500 characters), then click **Run**. For example:

* `Who can see Forecast?`
* `Remove Marketing's access to Accounting`

Cognee reads the sentence and answers, asks **Which … did you mean** when a name matches several things, or shows a preview of the change. **Nothing changes before you confirm**: a change shows how many people reach how many datasets before and after, plus anyone who **Still reach it another way**, and is applied only with **Confirm change**. **Discard** drops it.

Reading a sentence uses workspace credits. If the balance is empty, the field says so and links to **Buy more credits**.

> [!NOTE]
>
> **Check your access** (the member version, for example `Do I see Forecast?`) is shown but not active yet. Until it is, ask for access from the [Team matrix](#team-matrix).

## Needs attention

Admins and team admins get a **Needs attention** strip at the top of the page while something waits for their decision. It is hidden when nothing does.

* **Promotions**: questions that another team kept asking about your team's data, with who asked and how often. **Promote to …** answers the question from your team's data only and adds the answer to the asking team's **Promoted Memory** dataset; **Keep in …** shares nothing and closes the question. Both show a preview first, and promoting uses workspace credits.
* **New memory** and **Promote to Organisation**: facts an owner released for review. Choose **Share with the team**, **Promote to Organisation**, **Keep private** or **Keep in the team**. Source documents stay private either way.

Under **Manage access**, **Suggested by Cognee** proposes up to three changes, such as giving or removing a team's access to a dataset it does or doesn't use. **See all suggestions** lists the rest with **Apply** and **Apply all**; each change is previewed and confirmed like any other.

## Quick actions

Beside **Manage access**, admins get one-click shortcuts: **Invite to workspace**, **Create a team**, **Add people to a team** and **Sharing strength**. A team admin gets **Add people to your team** and **Sharing strength**.

## Your requests

When you have asked for access that is still waiting, **Your requests** lists each request in your own words, with the team whose data it is for and **sent** time, marked **waiting for a workspace admin**. **Withdraw** takes a request back. The part is hidden while you have none.

To send a request, open a cell in the [Team matrix](#team-matrix) and describe what you need and what for under **Request … data**. A workspace admin reads it and decides what to share. Answering requests on the page is rolling out; until then, admins answer them directly.

## Team matrix

The matrix shows which team can reach which team's data. Rows are teams; columns are the teams whose datasets they reach. Point at a cell to read what it counts, for example `Sales → Finance: 2 of 4 datasets; of 6 people, 3 full access, 1 partial`.

* A team's own column reads as its own team: everyone in a team sees its data.
* A dashed cell means **No data in that team yet**.
* In an admin's matrix, rings mark what waits on a pair: **Request waiting**, **Unusual, have a look** (amber) and **Likely shouldn't happen** (red). A small open dot means **Not checked by Cognee yet: no flag does not mean safe**.

**Admins** see the whole organisation and can open any cell. The side panel lists the column team's datasets (pick one in **Dataset**), who in the row team reaches each and how (**as its owner**, **given directly**, **through the … team**, **through the whole workspace**), and the dataset's **Sensitivity**. From here you can:

1. Click **Give** or **Remove** for a person, or for the whole row team on one dataset.
2. Read the preview: who reaches it now and after, and who keeps it another way.
3. Click **Give access** or **Remove access** to confirm, or **Cancel**. A confirmed change offers **Undo**.

**Members and team admins** switch between **You** (datasets you reach) and **Your team** (people in your team who reach each column). If you are in several teams, pick which team to show.

> [!NOTE]
>
> Nobody gives themselves access, a workspace admin included. You can remove your own access, but only another admin can give it back.

## Sharing

### Sharing strength

**Sharing strength** sets how freely new team memory reaches the organisation (or, for a team, how freely new memory reaches all of that team). Drag the slider between **Restricted**, **Cautious**, **Balanced**, **Generous** and **Open**; under it, the chart shows what last week's facts would have done at that setting. **Restricted** asks for approval every time. **Cautious**, **Balanced** and **Generous** also ask for approval while their cutoffs (95%, 85% and 75%) are provisional, and **Open** still needs the owner to release a fact, a working assessment and no unresolved conflict. Click **Preview change**, then **Confirm**, or **Discard change**.

## Teams and people

Admins switch between **Members** and **Teams**; team admins and members see their own teams. If you are not in a team yet, a workspace admin or a team admin adds you.

### Members

Everyone in the workspace, with their **Role**. Click **Invite member**, enter one or more emails and click **Send invite**. Existing Cognee accounts join straight away; anyone else gets an email and joins once they sign up with that address. Until then they show as **Pending**, with **Resend invite** and **Revoke invitation**. Admins can **Remove member**. If an invited teammate still can't reach the workspace, a shared dataset or your data from Claude, see [When a teammate can't reach your workspace or data](https://docs.cognee.ai/cognee-cloud/ui/members#when-a-teammate-cant-reach-your-workspace-or-data).

### Teams

Every workspace has an **Organisation** team that everyone belongs to. Nobody can add people to it, leave it, rename it or delete it; its admins are the organisation admins.

Open a team to see:

* **What this team does**: the team's purpose. Admins and the team's admins can **Edit purpose**, or **Infer purpose** to let Cognee suggest one.
* **Datasets**, each with its **Owner** (owning team) and the team's access level. **Promoted Memory** marks the team's promoted memory dataset.
* **Members**, each as **Member** or **Team admin** (**Organisation admin** in the Organisation team). Whoever may name admins switches the role here.

To create a team, the workspace admin clicks **Create team**, enters a **Team name** (up to 80 characters) and clicks **Create team**; they become its first member and team admin. **Add member** adds people.

**Assign dataset** gives the team datasets (up to 50 at a time) at one access level, the same for every member:

| Level | Allows |
| - | - |
| **Can view** | Search and read it |
| **Can edit** | Also add and cognify data |
| **Full access** | Also share and delete it |

A grant made through the API that matches no level shows as **Custom**. A new or private dataset added to a team becomes owned by that team; another team's dataset keeps its owner. **Create dataset** makes a new dataset the team owns; names cannot contain spaces or dots.

## History

The clock icon beside the page title opens **History**: for admins, every answer to a request, with who made it and when; for everyone else, their own requests and answers.

> [!NOTE]
>
> History is rolling out. The drawer opens but shows **Not available yet** until it is live.

## Related

> [card] [Permissions and memory promotion](https://docs.cognee.ai/cognee-cloud/functionality/memory-permissions.md)
>
> Teams, owning teams, agents and how memory is promoted.

> [card] [Permissions API](https://docs.cognee.ai/cognee-cloud/functionality/permissions-and-access-control.md)
>
> Endpoints for workspaces, teams, dataset grants and agents.


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