# spin share

**Spinbox is experimental: APIs change and data may be lost.** What is built and what proves it is on [Status](https://spin-stack.github.io/website/reference/status.md); what Spinbox does not do is on [Limitations](https://spin-stack.github.io/website/overview/limitations.md).

> spin share: Manage snapshot sharing.

<!-- Generated by tools/refgen from spin:cmd/cli. Edit the source, not this file. -->

```
Manage snapshot sharing.

Snapshots can be shared with specific users or made public.
Users can create new workspaces from shared snapshots using:
  spin workspace create --from-snapshot <snapshot-id>

Usage:
  spin share [flags]
  spin share [command]

Available Commands:
  add         Share a snapshot with a user
  browse      List snapshots shared with you
  list        List users who have access to a snapshot
  private     Make a snapshot private
  public      Make a snapshot public
  remove      Remove a user's access to a snapshot

Flags:
  -h, --help   help for share

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")

Use "spin share [command] --help" for more information about a command.
```

### spin share add

```
Share a snapshot with a user

Usage:
  spin share add <snapshot-id> <email> [flags]

Flags:
      --acknowledge-findings   Give the snapshot away although its files hold what looks like credentials
  -h, --help                   help for add

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```

### spin share browse

```
List snapshots shared with you

Usage:
  spin share browse [flags]

Flags:
  -h, --help     help for browse
      --public   Include public snapshots (default true)

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```

### spin share list

```
List users who have access to a snapshot

Usage:
  spin share list <snapshot-id> [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```

### spin share private

```
Make a snapshot private

Usage:
  spin share private <snapshot-id> [flags]

Flags:
  -h, --help   help for private

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```

### spin share public

```
Make a snapshot public

Usage:
  spin share public <snapshot-id> [flags]

Flags:
      --acknowledge-findings   Give the snapshot away although its files hold what looks like credentials
  -h, --help                   help for public

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```

### spin share remove

```
Remove a user's access to a snapshot

Usage:
  spin share remove <snapshot-id> <user-id> [flags]

Flags:
  -h, --help   help for remove

Global Flags:
      --config string    config file (default is $HOME/.spin/config.yaml)
  -o, --output string    text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string   named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
```