hostex

# Hostex API Skill (Node)

## Auth (PAT)

- Set env var: `HOSTEX_ACCESS_TOKEN`
- Requests use header: `Hostex-Access-Token: <PAT>`
- OpenAPI security scheme name: `HostexAccessToken`

**Default recommendation:** use a **read-only** PAT.

## Dates / timezone

- All date params are `YYYY-MM-DD`
- Interpret dates in **property timezone** (no UTC timestamps)

## OpenAPI source of truth

Stable OpenAPI JSON:
- https://hostex.io/open_api/v3/config.json

Use `scripts/openapi-sync.mjs` to cache a local copy into `references/openapi.json`.

## Quick commands (scripts)

All scripts expect `HOSTEX_ACCESS_TOKEN`.

### Read-only (safe)

List properties:
```bash
node skills/hostex/scripts/hostex-read.mjs list-properties --limit 20
```

List reservations (by check-in range):
```bash
node skills/hostex/scripts/hostex-read.mjs list-reservations --start-check-in-date 2026-02-01 --end-check-in-date 2026-02-28 --limit 20
```

List reservations (by reservation code):
```bash
node skills/hostex/scripts/hostex-read.mjs list-reservations --reservation-code 0-1234567-abcdef
```

Get availability:
```bash
node skills/hostex/scripts/hostex-read.mjs get-availabilities --start 2026-02-10 --end 2026-02-20 --property-id 123
```

### Writes (guarded)

Writes are disabled unless:
- `HOSTEX_ALLOW_WRITES=true`

and you pass `--confirm`.

Send message:
```bash
HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs send-message --conversation-id 123 --text "Hello!" --confirm
```

Update listing prices (single range example):
```bash
HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \
  --channel-type airbnb \
  --listing-id 456 \
  --start 2026-02-10 \
  --end 2026-02-15 \
  --price 199 \
  --confirm
```

Update listing prices (multi-range in one request):
```bash
HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \
  --channel-type booking_site \
  --listing-id 100541-10072 \
  --prices "2026-02-03..2026-02-...