whentomeet

# WhenToMeet Skill

Use this skill for authenticated management of planning events.
More info about whentomeet.io: https://whentomeet.io/llms.txt

## Activation criteria

Use when user asks to:

- Create an event with candidate time slots
- List their events
- Fetch details for one event
- Delete an event

Do not use if the request requires undocumented endpoints/fields.

## Required context

- Env var: `WHENTOMEET_API_KEY`
- Base URL: `https://whentomeet.io/api/trpc`
- Auth: `Authorization: Bearer $WHENTOMEET_API_KEY`
- tRPC payload envelope: `{"json": {...}}`
- For GET, pass URL-encoded `input=<encoded {"json": ...}>`

## Available scripts

- `scripts/w2m_events.py` — non-interactive CLI for `create`, `list`, `get`, `delete`, and `encode-input`.

## Supported procedures (v1)

- `v1.event.create` (POST)
- `v1.event.list` (GET)
- `v1.event.get` (GET)
- `v1.event.delete` (POST)

## Core data model

Event fields:

- `id` (UUID)
- `title` (string)
- `description` (optional string)
- `status` (`PLANNING` or `FINALIZED`)
- `publicUrl` (URL)

Slot fields:

- `startTime` (ISO-8601)
- `endTime` (ISO-8601)

## Preconditions

Before calling API:

1. Ensure API key exists.
2. Ensure each slot has valid ISO timestamps and `endTime > startTime`.
3. For delete, require explicit user confirmation with exact `eventId`.

## Preferred workflow (script-first)

Run commands from the skill root.

List events:

```bash
python3 scripts/w2m_events.py list
```

Create event:

```bash
python3 scripts/w2m_events.py create \
  --title "Team Sync" \
  --description "Optional description" \
  --slots-json '[{"startTime":"2026-03-02T12:00:00.000Z","endTime":"2026-03-02T13:00:00.000Z"}]' \
  --modification-policy EVERYONE
```

Get event:

```bash
python3 scripts/w2m_events.py get --event-id "uuid"
```

Delete event (requires explicit confirmation flag):

```bash
python3 scripts/w2m_events.py delete --event-id "uuid" --confirm
```

Encode GET input payload:

```bash
python3 scripts/w2m_events.py en...