# spin ssh-key

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

> spin ssh-key: Manage SSH keys.

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

```
The SSH keys you log in to workspaces with: every workspace you own or are a guest of
certifies a key listed here, for five minutes at a time.

A key of your own is added once, confirmed with your passkey in the browser, and stays until you
delete it. The browser's terminal and editor add a key of their own for twelve hours, listed here
with when it runs out (docs/access.md).

Usage:
  spin ssh-key [flags]
  spin ssh-key [command]

Available Commands:
  add         Add an SSH key of yours, confirmed with your passkey in the browser
  delete      Delete an SSH key from your account
  list        List the SSH keys you log in with

Flags:
  -h, --help[=true|false]   help for ssh-key

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")
      --traceparent string   the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false

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

### spin ssh-key add

```
Add an SSH public key you log in to your workspaces with, from then on.

A key logs in as you, so adding one takes your passkey: this opens the page where you confirm
it, and waits until you have.

Examples:
  spin ssh-key add laptop ~/.ssh/id_ed25519.pub
  spin ssh-key add work-key /path/to/key.pub
  spin ssh-key add mykey - < key.pub  # Read from stdin

Usage:
  spin ssh-key add <name> <public-key-file> [flags]

Flags:
  -h, --help[=true|false]         help for add
      --no-browser[=true|false]   print the page where your passkey confirms, instead of opening it

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")
      --traceparent string   the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
```

### spin ssh-key delete

```
Delete an SSH key from your account

Usage:
  spin ssh-key delete <key-id> [flags]

Flags:
  -h, --help[=true|false]   help for delete
  -y, --yes[=true|false]    Skip confirmation

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")
      --traceparent string   the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
```

### spin ssh-key list

```
List the SSH keys you log in with

Usage:
  spin ssh-key list [flags]

Flags:
  -h, --help[=true|false]   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")
      --traceparent string   the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
```
