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

# Sharing

> Send someone a link to an agent, a run, or a runs list — how the invitation works and what accepting grants.

Sharing sends a link by email that gives one person access to one specific object.

<Info>
  Sharing is a web UI feature. There is no `jstm share` command.
</Info>

## What can be shared

| Target    | What the recipient sees                    |
| --------- | ------------------------------------------ |
| Agent     | The agent, its definition, and its history |
| Run       | One run: its stories, output, and evidence |
| Runs list | The workspace's runs                       |

## The invitation flow

```mermaid theme={null}
flowchart LR
    A[You share a target<br/>with an email address] --> B[Recipient gets a link<br/>expires in 7 days]
    B --> C["Preview: who invited them,<br/>which workspace, what object"]
    C --> D[Accept]
    D --> E[Added to the workspace<br/>as a member]
    E --> F[Taken to the object]
```

The link is tied to that email address and expires after **7 days**. There is no never-expires option.

The preview step means the recipient sees who invited them, which workspace, and what the object is, before committing to anything.

If the recipient is already a member of the workspace, there is nothing to accept and they go straight to the object.

## What accepting grants

<Warning>
  Accepting a share adds the person to the workspace as a **member** — not as a viewer, and not scoped to the shared object alone. They gain access to the workspace.
</Warning>

That is deliberate: sharing is designed to bring someone into the work, not to hand out a read-only window. But it means a share is a membership decision, so treat it as one.

To give someone genuinely narrow access, add them to a workspace that holds only what they should see.

## Who can share

You must be a member of the workspace that owns the object.

| Workspace type | Required               |
| -------------- | ---------------------- |
| Organization   | Any role except viewer |
| Team           | Owner or admin         |
| Personal       | Not supported          |

Objects owned by a personal workspace can't be shared at all. Move them to a team workspace first with `jstm agent move`.

## Resending and revoking

**Resend** sends the invitation email again and resets the 7-day expiry.

**Revoke** invalidates the link. An unaccepted share stops working immediately.

Revoking does not remove someone who already accepted. To remove their access:

```bash theme={null}
jstm workspace member-remove acme-corp/finance --user-id dana --yes
```

## Sharing versus visibility

|                   | Use it for                                                             |
| ----------------- | ---------------------------------------------------------------------- |
| **Share**         | One person, one object. Often someone outside the workspace            |
| **`ORG_VISIBLE`** | A capability the whole organization should be able to find and install |

See [Visibility and discovery](/features/visibility-and-discovery).

## See also

* [Share agents and runs](/guides/share-agents-and-runs) — walkthrough.
* [Invite and manage members](/guides/invite-and-manage-members)