remind_pass_window_queue

Nudge everyone who bought a window but has not come through their grant yet, re-sending it. Messages real people.

Purpose

A pass holder who bought a window still has to come through their grant (on Telegram, tap the invite link and send a join request) before the window opens; the ones who have not are the window's queue. This tool re-sends the grant to every holder still in that queue, the way the dashboard's "remind everyone" action on a window does, and answers with how many holders the connector accepted the message for.

A window that has ended or been cancelled has nobody left to remind and answers 0. Holders who already queued are skipped.

This messages real people

Confirm with the creator before calling, and do not repeat it within the same window — the queue does not change because it was nudged twice. To remind one holder, use remind_pass_holder.

Required ability

pass-window:update

Input schema

{
  "type": "object",
  "required": ["project_id", "window_id"],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "UUID of the project whose pass plans own the window."
    },
    "window_id": {
      "type": "string",
      "description": "UUID of the window whose missing holders to nudge."
    }
  }
}

Output shape

{
  "data": {
    "window_id": "3d5a8c72-b016-4e94-8fa7-61c209d4e738",
    "reminded": 4
  }
}

reminded counts messages the connector accepted, not holders in the queue: a holder who has blocked the bot is in the queue but cannot be reached, and is not counted.

Example prompts

"Remind everyone who bought Saturday's window in project 7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13 but hasn't joined yet."

"The 3 October window opens in an hour — nudge the stragglers."

"How many holders of window 3d5a8c72-b016-4e94-8fa7-61c209d4e738 did the reminder reach?"

Failure modes

VALIDATION_FAILED — the reminder was refused for the window's current state.
RESOURCE_NOT_FOUND — unknown project_id or window_id, a window of another project, or a project outside the token's scope.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks pass-window:update.

remind_pass_holder — the same nudge for one subscription.
get_pass_window — how many holders the window has.
Pass windows API — the REST equivalent.