remind_pass_holder

Nudge one pass holder who bought a window but has not come through their grant yet. Answers whether anything was sent.

Purpose

The members page's per-holder nudge: re-sends one subscriber's invite links for the window they bought, when they have not yet come through their grant. Use it when a specific member says "I never got the link"; to reach everyone still missing from a window at once, use remind_pass_window_queue.

reminded: false is a normal answer, not an error. It means there was nothing to send: the subscription holds no window, the window has ended or been cancelled, the holder has already queued, or they cannot be reached on their connector. It is the dashboard's "Nothing sent" notice.

This messages a real person

Read the subscription back with get_subscription first, and do not repeat the nudge within the same window.

Required ability

project-subscription:update

Input schema

{
  "type": "object",
  "required": ["subscription_id"],
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "UUID of the pass holder's subscription."
    }
  }
}

Output shape

{
  "data": {
    "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
    "reminded": true
  }
}

Example prompts

"Resend the invite link to the holder of subscription 5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4."

"This member says they never got their link for Saturday — nudge them."

"Did the reminder for that pass holder actually go out?"

Failure modes

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

remind_pass_window_queue — everyone still missing from a window.
get_subscription — read the state back first.
Subscriptions API — the REST equivalent, POST .../remind.