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

> ## Agent Instructions
> Describe what the running code does. Do not invent hosted pricing, launch dates, or security guarantees. Share and viewer links are a configured base URL plus an artifact path. Show localhost and a placeholder origin such as https://library.example.com.

# share

> Create a public link. Add --password, --remove-password or --revoke.

```text theme={null}
Usage: factrove share <id> [--password | --password-stdin | --remove-password | --revoke] [--json]

Creates a public link, or prints the existing one.

Options:
  --password         Prompt twice for a link password. Needs a terminal.
  --password-stdin   Read the link password from a pipe.
  --remove-password  Keep the link and remove its password.
  --revoke           Remove the public link and its password.
  --json             Print one JSON line.
```

## Accepted flags

The help text above is exact. These flags are also accepted, including ones that help text does not list.

* `--password` — Prompt twice for a link password. Needs a terminal.
* `--password-stdin` — Read the link password from a pipe.
* `--remove-password` — Keep the link and remove its password.
* `--revoke` — Remove the public link and its password.
* `--json` — Print one JSON line (alias: --output json).
* `--output <json|text>` — Print one JSON line when the value is json. --output text is the plain output.
* `--api-url, --endpoint-url <origin>` — API origin (alias: --endpoint-url).
* `--profile <name>` — Credentials profile (default: default). Accepted on every command. Help lists it on configure.
* `--quiet` — Accepted on upload, get, share, list, rename, and delete. It does not hide their output. Help does not list it. configure rejects it.
* `-h, --help` — Show help.

## Behavior

Plain success prints the public URL and then a status line that says whether the link is password protected. `--json` prints one `{ share }` line. Upload is the command that prints only an id.

`--password` prompts twice and needs a terminal. `--password-stdin` reads a pipe and removes one trailing newline. An agent can run `printf '%s' "$LINK_PASSWORD" | factrove share "$artifact_id" --password-stdin`.

`--revoke` removes the link and its password. Sharing again without a password creates an unprotected link. Pass the password again to keep protection. See [Sharing links](https://docs.factrove.app/guides/sharing-links.md#lockout-recovery).

## Related

* [Sharing links](https://docs.factrove.app/guides/sharing-links.md)
* [Create or update a public share](https://docs.factrove.app/api-reference/shares/create-or-update-a-public-share.md)


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