rwx apps share

Create a share link for a private preview app. Requires the run:manage permission.

Anyone with the share link can access the app without an RWX account until the link expires.

Usage

rwx apps share ENDPOINT_OR_URL [flags]

Examples

Create a share link that expires in seven days:

rwx apps share my-app-pr-123

Set a description and an expiration duration:

rwx apps share my-app-pr-123 --description "Customer demo" --expires-in 1d

Arguments

ENDPOINT_OR_URL (required)

The app's URL or endpoint, such as my-pr-123. Use an endpoint or friendly URL to share a link that will move with the latest preview. Use a canonical URL to pin to a specific version. See Sharing the preview link for more information on the URL formats.

Options

--description <description>

An optional description for the share link.

--expires-in <duration>

How long the share link grants access. Defaults to seven days. Examples: 1h, 1d, 7d.

Output

By default, the command prints only the share URL followed by a newline.

With --json or --format json, it returns an object with these fields:

Global options

--format <format>

Output format: text or json. Defaults to text.

--json

Output JSON data to stdout. Equivalent to --format json.

--access-token <token>

The access token for RWX. Defaults to the value of the $RWX_ACCESS_TOKEN environment variable.