# Sharing a port

> Expose a port and reachpad mints a link to what this workspace is serving. Useful when an agent has built something you want to look at.

Part of the reachpad docs: https://reachpad.dev/docs. Rendered page: https://reachpad.dev/docs/ports. Last checked 2026-08-21.

## Expose a port

```bash
reachpad ports expose 3000 <id>
reachpad ports list <id>
reachpad ports revoke 3000 <id>
```

The port is the one your app is listening on inside the workspace. Every verb takes the port first and the workspace second, and the workspace can come from `-w` or `REACHPAD_WORKSPACE` instead. The same controls are on the workspace's page in your [dashboard](https://reachpad.dev/dashboard/workspaces).

Re-running `expose` for a port that is already open returns the same link rather than a second one. `list` shows the open ports oldest first, with their links.

## Who can open the link

> Note: Anyone signed in to reachpad who has the link can view it. It is not a private URL and it is not a secure link. It carries no port, no workspace id and no account name, which is all it does carry.

Treat it the way you would treat a preview deployment URL: fine for a demo, not a place to serve anything that must not be seen.

## Closing one

`ports revoke` stops the link at the visitor's next request. Re-opening the same port later mints a new link: a closed one never comes back.