# Welcome to the Bridge

You've reached Urania's command center. This is where you manage your account, organizations, and deployments.

## Getting Started

**New to Urania?** Request a passphrase to get started:

```
POST /auth/request-login
Content-Type: application/json

{ "email": "you@example.com" }
```

A memorable passphrase will be emailed to you. Then verify it:

```
POST /auth/verify
Content-Type: application/json

{ "email": "you@example.com", "passphrase": "your passphrase here" }
```

Once verified, use the passphrase as your Bearer token for all requests.

## What You Can Do Here

### Account & Authentication

| Endpoint | Description |
|----------|-------------|
| `GET /auth/me` | Check your current session |
| `GET /auth/keys` | List your passphrase keys |
| `DELETE /auth/keys/:keyId` | Terminate a key |
| `POST /auth/logout` | Clear current session |

### Organizations

| Endpoint | Description |
|----------|-------------|
| `GET /orgs` | List your orgs |
| `POST /orgs` | Create a new org |
| `POST /orgs/:orgId/members` | Add a member |
| `DELETE /orgs/:orgId/members/:userId` | Remove a member |

> **Tip:** All `:orgId` parameters accept either the org ID (UUID) or slug.
> Example: `/orgs/fernando/control` or `/orgs/abc123-uuid-here/control`

### Access Control

| Endpoint | Description |
|----------|-------------|
| `GET /orgs/:orgId/acl` | List permission rules |
| `POST /orgs/:orgId/acl` | Create a rule |
| `DELETE /orgs/:orgId/acl/:ruleId` | Delete a rule |

### Domains

Serve your org's files from a custom domain. The flow:
1. Claim the domain (optionally specify a target path)
2. Add the DNS TXT record we provide (proves ownership)
3. Call verify — we check DNS and provision a TLS certificate via Fly.io

Once verified, requests to your domain route to your org's files. You'll need access to your domain's DNS settings to complete verification.

| Endpoint | Description |
|----------|-------------|
| `GET /orgs/:orgId/domains` | List domains |
| `POST /orgs/:orgId/domains` | Claim a domain |
| `PATCH /orgs/:orgId/domains/:id` | Update target path |
| `POST /orgs/:orgId/domains/:id/verify` | Verify DNS |
| `DELETE /orgs/:orgId/domains/:id` | Remove domain |

### Control

| Endpoint | Description |
|----------|-------------|
| `GET /orgs/:orgId/control` | Mission control dashboard |
| `GET /orgs/:orgId/control/boxes` | List active boxes |
| `GET /orgs/:orgId/control/drones` | List active drones |
| `GET /orgs/:orgId/control/fuel` | Fuel history |
| `GET /orgs/:orgId/control/cooling` | Cooling metrics |
| `GET /orgs/:orgId/traces` | Trace events (3-day retention) |

### Debug

| Endpoint | Description |
|----------|-------------|
| `POST /orgs/:orgId/debug/validate-box` | Test if a message matches a box schema |

### The Sim

Learn SandScript in a safe environment with zero side effects:

| Endpoint | Description |
|----------|-------------|
| `GET /sim` | SandScript tutorial and reference |
| `POST /sim` | Evaluate code (send SandScript as body) |

## Explore

Every endpoint returns helpful markdown. Just try things - the platform will guide you.

---

*[Urania](https://urania.blue) — your AI's shortcut to production*