# Addresses and URLs

> Every public address in Facia, from app routes and HQ tabs to settings pages, embeds, invites, API endpoints and docs files.

# Addresses and URLs

Replace `<base>` with any of your business's addresses: your domain, `yourhandle.facia.chat`, or `facia.chat`.

## App

| Address | What |
| --- | --- |
| `/` | Your business (on your own address), or the portal on facia.chat |
| `/@handle` | A business's page on facia.chat |
| `/c/<chat>` | A chat (for staff, the business chat is the inbox) |
| `/c/<chat>/t/<thread>` | A client's thread inside the business chat |
| `/settings` | Personal settings. `?page=look` opens Look |
| `/join/<code>` | Group or channel invite |
| `/team/<code>` | Team invite |
| `/setup/<token>` | One-time setup link for a newly approved server |
| `/embed/<handle>` | The embeddable chat |
| `/leaderboard/<business>` | Leaderboard |
| `/play/<business>` | Games & more |
| `/spin/<block>` | A raffle spin |
| `/cards/<business>` | High Card |
| `/app/<business>/<app>` | An app tab |
| `/hq` | HQ |
| `/live` | Live TV |

## HQ tabs and settings pages

`/hq?tab=` `overview` · `analytics` · `clients` · `payments` · `team` · `activity` · `bots` · `settings`

`/hq?tab=settings&page=` `general` · `features` · `appearance` · `blocks` · `games` · `apps` · `replies` · `ai` · `email` · `perms` · `refer` · `connect`

`/hq?tab=settings&business=<id>` opens one business's settings.

## Links you can add to

| Add | Effect |
| --- | --- |
| `?src=name` or `?utm_source=name` | Campaign tag for Sources |
| `?ref=CODE` | Member invite code, or a referral code on the front page |
| `#name=…&theme=…&accent=…` | Embed hints (see [Embed](https://docs.facia.chat/setup/embed)) |

## Files

| Address | What |
| --- | --- |
| `<base>/widget.js` | The chat-button embed script |
| `https://facia.chat/app/facia-app.js` | The app bridge script |

## API

| Address | What |
| --- | --- |
| `POST https://site.facia.chat/partner/v1/<call>` | [Partner API](https://docs.facia.chat/build/partner-api) (use the exact `FACIA_API` from HQ) |

## Docs

| Address | What |
| --- | --- |
| `https://docs.facia.chat` | These docs |
| `https://docs.facia.chat/<page>.md` | Any page as Markdown |
| `https://docs.facia.chat/llms.txt` | Index for AI assistants |
| `https://docs.facia.chat/llms-full.txt` | All docs in one file |
| `https://docs.facia.chat/sitemap.xml` | Sitemap |
