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

# Share a project

> Give workspace members read or write access to a project, change their permission, or revoke it.

Members of a workspace only see the projects shared with them. Workspace owners and admins already have write access to every project in the workspace, so you share projects with members.

## Before you share

* You need write access to the project.
* The person must already be a member of the project's workspace. To add someone new, [invite them to the workspace](/collaborate/members-and-roles#invite-someone) first.

## Permissions

| Permission | Can |
| - | - |
| **Read** | Open the project, view the schema and rows, view the activity log, export CSV, and use the project through an AI assistant with read tools |
| **Write** | Everything in Read, plus create and drop tables, add and drop columns, insert, edit, and delete rows, and share the project with other workspace members |

Only the project creator and workspace owners and admins can delete a project. A write permission does not include deletion.

## Add someone

<Steps>
  <Step title="Open the sharing dialog">
    Open the project and select **Add** in the header.
  </Step>

  <Step title="Choose a person and permission">
    Select a workspace member from the list, then choose **Read** or **Write**. The list only contains workspace members who don't have a grant on this project yet.
  </Step>

  <Step title="Add">
    Select **Add**. They can open the project right away.
  </Step>
</Steps>

<Frame caption="The Add people dialog lists everyone with a grant.">
  <img src="https://mintcdn.com/auxilian/G4v3XTDP6dLj30co/images/share-dialog.png?fit=max&auto=format&n=G4v3XTDP6dLj30co&q=85&s=4a81dcebb5611d89e6ae6a72461f1938" alt="The Add people dialog with a member picker, an Access menu set to Read, an Add button, and two people with write and read access" width="2720" height="1640" data-path="images/share-dialog.png" />
</Frame>

## Change someone's permission

The sharing dialog shows each person's current permission. To change it, [revoke their access](#revoke-access), then add them again with the other permission.

## Revoke access

<Steps>
  <Step title="Open the sharing dialog">
    Open the project and select **Add** in the header. The dialog lists everyone with a grant.
  </Step>

  <Step title="Revoke">
    Select **Revoke** next to the person, then **Revoke** again in the confirmation. They lose access immediately.
  </Step>
</Steps>

You can't revoke the project creator, and you can't remove the last person with write access.

<Note>
  Revoking a member's grant doesn't affect workspace owners and admins. They keep write access to every project in their workspace for as long as they hold that role.
</Note>

## Sharing and AI assistants

AI assistants can't share projects or change access. When you share a project with someone, any assistant they've connected can use it with the permission you granted. When you revoke access, their assistant loses it too.

Sharing changes appear in the activity log as `member.invited` and `member.revoked`.


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