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

# Public URLs

> Share an app running on a computer at an https address

A public URL serves one port on a computer at an address like `https://cool-thing-x7k2.orgo.dev`, with HTTPS, to anyone who has the link. Use it to show a site an agent built, share a dashboard, or receive webhooks.

> [!NOTE]
>
> Public URLs need a paid plan or credits you've bought. They work on Linux and Windows computers.

## Listen on 0.0.0.0

The app must listen on `0.0.0.0`, not `127.0.0.1` or `localhost`, or the URL can't reach it:

```bash theme={null}
python3 -m http.server 3000 --bind 0.0.0.0
```

Most dev servers have a host flag for this, such as `--host 0.0.0.0`.

## Create one

In the dashboard, open the computer's **⋯** menu, choose **Public URLs**, enter the port and an optional name, and click **Add**.

With the API:

```bash theme={null}
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/public-urls \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"port": 3000, "name": "cool-thing"}'
```

```json theme={null}
{
  "id": "6f1c2a7e-3b9d-4c1a-9e2f-0a1b2c3d4e5f",
  "url": "https://cool-thing-x7k2.orgo.dev",
  "hostname": "cool-thing-x7k2.orgo.dev",
  "label": "cool-thing-x7k2",
  "port": 3000,
  "created_at": "2026-10-05T18:00:00.000Z",
  "protected": false
}
```

Use the `url` in the answer. Orgo adds 4 characters after the name, so the address can't be known in advance.

## Names

* 2 to 16 lowercase letters, digits and hyphens, starting and ending with a letter or digit. No `--`, and not only digits.
* Orgo refuses names that use `orgo`, `bops`, brand names or words common in phishing.
* Leave out `name` and Orgo picks one, like `keen-otter-x7k2`.

## Ports

Any port from 1 to 65535, except the ones the computer uses itself: 22, 3389, 5900 to 5999, 6080 to 6099, 8080 and 9000. A computer has one URL per port. To serve another port, [update](https://docs.orgo.ai/api-reference/public-urls/update.md) the URL or make a new one.

## Password

Set a password to keep a URL private:

```bash theme={null}
curl -X PATCH https://www.orgo.ai/api/computers/$COMPUTER_ID/public-urls/$URL_ID \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"password": "k7Rm2qX"}'
```

* Browsers see a password form first. Any other request without the form's cookie, such as an API call, a WebSocket or a webhook, gets `401`. Keep a URL that receives webhooks open.
* A program can send the cookie from [Get public URL password](https://docs.orgo.ai/api-reference/public-urls/password.md) instead of filling in the form.
* A new password signs out everyone who entered the old one. `"password": null` removes it.
* Changes are live within 5 seconds.

## Limits

[List public URLs](https://docs.orgo.ai/api-reference/public-urls/list.md) returns `limit`, the most this computer can have, and `account_limit`, the most the workspace owner can have across all their computers. Each person can make 30 new URLs a day, reset at 00:00 UTC.

## When the computer is off

While the computer is stopped or asleep, the URL shows a page saying the computer isn't running. It serves the app again once the computer starts.

## Remove one

Removing a URL stops serving it. The app on the computer keeps running. For 30 days, only the workspace owner can take the address back, by sending its full label, for example `"label": "cool-thing-x7k2"`, to [Create public URL](https://docs.orgo.ai/api-reference/public-urls/create.md).

> [!NOTE]
>
> Where public URLs aren't on for your account, [List public URLs](https://docs.orgo.ai/api-reference/public-urls/list.md) answers `enabled: false` and the other calls answer `404`.

## API

| Call | What it does |
| - | - |
| [List public URLs](https://docs.orgo.ai/api-reference/public-urls/list.md) | The computer's URLs and limits |
| [Create public URL](https://docs.orgo.ai/api-reference/public-urls/create.md) | Serve a port at a new address |
| [Update public URL](https://docs.orgo.ai/api-reference/public-urls/update.md) | Change the port, or set or remove a password |
| [Delete public URL](https://docs.orgo.ai/api-reference/public-urls/delete.md) | Stop serving a URL |
| [Get public URL password](https://docs.orgo.ai/api-reference/public-urls/password.md) | The password and the cookie that opens it |


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