# Shared Routers

Routers used by both UI and operations.

```{contents} Table of Contents
:depth: 2
:local: true
```

## Auth Routers

**Paths**: `/auth`, `/github`, `/api/tokens`

**Purpose**: Authentication and token management

**Key endpoints**:

- `GET /github/login` - Initiate OAuth
- `GET /github/callback` - OAuth callback
- `GET /auth/me` - Current user info
- `GET /api/tokens/scopes` - Get available scopes
- `POST /api/tokens/` - Create API token (one-time display)
- `GET /api/tokens/` - List tokens
- `GET /api/tokens/{id}` - Get token details
- `PUT /api/tokens/{id}` - Update token
- `GET /api/tokens/{id}/usage` - Get usage statistics
- `POST /api/tokens/{id}/regenerate` - Regenerate token
- `DELETE /api/tokens/{id}` - Revoke token
- `POST /api/tokens/bulk-revoke` - Bulk revoke
- `GET /api/tokens/export` - Export token list

See {doc}`../../AuthToken` for complete endpoint documentation.

## Instruments Router

**Path**: `/instruments`

**Purpose**: Query instrument configurations

**Key endpoints**:

- `GET /` - List instruments
- `GET /{id}/modules` - Get modules
- `GET /modules/{id}/configurations` - Get configurations

**Used by**:

- UI: Display instrument info
- Operations: Validate configurations

## Site Router

**Path**: `/api/site`

**Purpose**: Site configuration and status

**Key endpoints**:

- `GET /info` - Site configuration
- `GET /health` - Health check
- `GET /buffer-stats` - Buffer statistics

**Example**:

```bash
curl http://localhost:8000/health
```

```json
{
  "status": "healthy",
  "database": "connected",
  "redis": "connected",
  "transaction_buffer": {"size": 5}
}
```

## Demo Router

**Path**: `/api/demo`

**Purpose**: Testing and examples

**Key endpoints**:

- `POST /create-observation` - Demo buffered operation
- `GET /operation-examples` - List examples
- `GET /site-info` - Site information

## Next Steps

- {doc}`../authentication/index` - Authentication details
- {doc}`../../architecture/site-configuration` - Site configuration