> ## 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.

# Share agents and runs

> Send someone a link to an agent, a run, or a workspace's run list — including people who aren't in your workspace yet.

Sharing sends a link by email that gives the recipient access to one specific thing: an agent, a single run, or a workspace's runs list.

This is how you show a stakeholder the evidence behind a run without walking them through the whole product, and how you bring a new colleague into a workspace around real work rather than an empty invitation.

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

## What you can share

| 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                       |

## How it works

1. You choose a target and enter an email address.
2. The recipient gets an email with a link. The link is tied to that address and expires in **7 days**.
3. Opening it shows a preview — who invited them, which workspace, and what the target is — before they commit to anything.
4. Accepting adds them to the workspace as a **member** and takes them to the object.

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

<Warning>
  Accepting a share adds the person to your workspace as a member. They get access to the workspace, not only to the shared object. Share deliberately.
</Warning>

## 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       | Sharing is not supported |

To share something built in your personal workspace, move it to a team workspace first:

```bash theme={null}
jstm agent move failed-payment-digest --to acme-corp/finance
```

See [Organize and publish agents](/guides/organize-and-publish-agents).

## Managing shares you've sent

You can see the shares you've sent, and for each one:

* **Resend** — sends the invitation email again and resets the 7-day expiry.
* **Revoke** — invalidates the link. An unaccepted share stops working immediately.

Revoking a share does not remove someone who already accepted it. To remove their access, remove them from the workspace:

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

## Sharing inside your organization

For an agent that a whole organization should be able to find and use, visibility is a better fit than a share:

```bash theme={null}
jstm agent visibility failed-payment-digest ORG_VISIBLE
```

Any workspace in the organization can then discover it with `jstm agent search` and install their own copy, running it with their own credentials. See [Visibility and discovery](/features/visibility-and-discovery).

Use sharing for a specific person and a specific thing. Use visibility for a capability the organization should be able to reuse.

## See also

* [Sharing](/features/sharing) — the model.
* [Invite and manage members](/guides/invite-and-manage-members)