MCP reference

Allocates a block of a location's permitted time to a program, in the connected organization.

Removes an allocated block of location time from the organization. Destroys data: the first call previews what would happen, including how many scheduled games would lose their allocated location, and writes nothing; call again with the returned confirmation_token to actually remove it.

Lists every block of time allocated on one location in the connected organization.

Lists every block of location time allocated to a program, across every location in the connected organization.

Corrects an existing allocation block's time window or its cost, in the connected organization.

Hand-assigns a location to an area, or clears its assignment. Never derived from the location's geo. Calls the same underlying write path as PATCH /api/locations/{location}.

Creates an area (up to two levels, org-defined labels) in the connected organization. Never derived from a location's geo — hand-created only.

Deletes an area from the organization. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually delete it. Refused if the area still has a child area or an assigned location.

Returns full detail for one area, including its immediate children and assigned locations, in the connected organization.

Lists areas in the connected organization.

Renames an area, changes its label, or moves a second-level area under another top-level area. Only the fields supplied are changed. An area's level is permanent; a top-level area has no parent.

Asks this organization to email an address when a program opens for registration in an area (a level-1 area includes its level-2 areas), or, with no area, when any of its programs opens. Sends one confirmation email; nothing else is sent until the address's owner confirms. The answer is the same whether or not the address was already subscribed.

Starts connecting the organization's own Stripe account so it can take payments. Returns a Stripe link for the organizer to open in a browser; Stripe asks them to create an account or sign in. Nothing is charged. Call it again once they have finished: payments_connected is Stripe's answer at that moment.

Disconnects the organization's Stripe account so it can be connected again from scratch (for example after signing in to the wrong Stripe login). New payments stop until connect-payments is called again, which then creates a new account. Past payments, refunds and payouts stay with the old account. The first call previews, with how many payments the account took and how many checkouts are open on it; call again with the returned confirmation_token to disconnect.

Records a blackout (date + reason) on a field, in the connected organization. Draft games already on that field and date move to Held; committed games stay where they are and are listed in the result.

Lists blackouts recorded for a field, in the connected organization.

Adds a contact by email to a contact list in the connected organization. Idempotent — adding an already-present email changes nothing.

Creates a named contact list in the connected organization.

Deletes a contact list and its memberships. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually delete it. Contact records and suppression (unsubscribe/bounce) state are unaffected, and there is no undo.

Returns one contact list in the connected organization, including its contacts.

Imports contacts into a contact list from an existing source (division registrants, a team roster, or organization members). This is a one-time snapshot — the list does not stay in sync with the source afterward.

Lists the people announcements skip, whether they unsubscribed themselves or an organizer stopped announcements for them: address, whether it was their own unsubscribe or an organizer's stop, when, by whom and the note. The "opted out" count on a new announcement counts these. Needs the right to send announcements.

Lists the announcements the connected organization has sent, each with when it went out, how many it was enqueued to, and how many contacts were suppressed.

Lists the connected organization's contact lists, each with its member count.

Removes a contact from one contact list. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it. The contact is NOT unsubscribed and stays on any other list — this only removes one list membership.

Sends one already-sent announcement to ONE of its recipients again — the retry for a soft bounce such as a full mailbox. Sends real mail, which cannot be unsent: the first call previews what would happen and sends nothing; call again with the returned confirmation_token to actually send. Refuses outright for a hard-bounced, complained-about or unsubscribed address, naming which.

Sends an announcement email to every non-suppressed contact in the connected organization, in one of its programs or divisions (everyone registered in it), or on one of its contact lists. Replies go to the organization's announcements address, not to Messages. A real, external, hard-to-fully-undo mail delivery under the organization's own sending domain — there is no unsend. This action destroys nothing directly but cannot be reversed once sent: it takes effect only after a human signed in to Hollis has reviewed and approved it, and cannot be redeemed a second time for a different message or a different list.

Stops announcements to one person of the connected organization — a contact or a member who asked to stop (by phone or email), or whose address keeps bouncing. Every announcement audience leaves them out from then on, and the "opted out" count includes them. Only the person can turn announcements back on: an organizer cannot undo this, and there is no tool to. Idempotent; an address that already stopped, for any reason, is left exactly as it was. Needs the right to send announcements.

Corrects one contact's email address on a contact list. Overwrites the stored address: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually change it. IMPORTANT to relay: bounce and complaint suppressions are recorded against an ADDRESS, so changing it stops this contact being suppressed and mail will be sent to them again.

Returns one member's credit with the connected organization: the balance, every part of it (available, held, spent or expired) with its source and expiry date, and each use of it (toward a payment, given to another member, or withdrawn to a card). Read only: credit cannot be voided or paid out as cash, and only the holder can give it to someone else. Needs payments.view.

Returns the caller's own credit balance with this organization and each unexpired part of it with its expiry date. Credit comes off the next registration the caller pays for; it cannot be turned into cash, except a captain's credit from free agents placed on a team they paid for in full (withdraw-credit), and can be given to another person in the organization with transfer-credit. held_cents is that captain credit still held until its season ends: not in the balance, and neither spent nor withdrawn before then.

Gives part or all of the caller's own credit with this organization to another member of it. The credit keeps its expiry dates and cannot come back unless they give it back. The first call previews what would happen and writes nothing; repeat it with the confirmation_token it returns.

Refunds the caller's credit from free agents' fees on a team they paid for in full to the card they paid that team's entry with, capped at what the card paid. That credit is held until the season ends and cannot be withdrawn before. registration_id is the caller's own registration on that team; amount_cents defaults to all of it. Other credit cannot be withdrawn. The first call previews what would happen and writes nothing; repeat it with the confirmation_token it returns.

Applies a shared discount code to the caller's own unpaid registration (design-v2 D-103), lowering what pay-registration will charge. One code per registration; a second replaces the first. An open checkout for it is closed first.

Makes a shared discount code for one program (design-v2 D-103), e.g. SIBLING10: a percentage OR an amount off, with an optional cap on uses and an expiry, and optionally for first-time players only, once per person, or for one person only (only_for_email: anyone else is told the code is not valid, as for an unknown code; such a code is used once unless max_uses says otherwise). A code always covers the whole program, never one division. Payers apply it to their own unpaid registration before paying. Anyone holding the code can use it, so give it a cap or an expiry when it should not spread.

Lists a program's shared discount codes (design-v2 D-103): each code, what it takes off, how many times it has been used, its cap, expiry and whether it was withdrawn. Needs the right to edit the program.

Brings back a withdrawn shared discount code, so payers can apply it again under its own limits. Its uses so far still count against its cap.

Withdraws a shared discount code (design-v2 D-103). Nobody can apply it again; registrations that already used it keep their price.

Creates a division (age group or skill tier) within a program in the connected organization.

Removes a division from a program. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it. The removal is a soft delete — nothing is permanently destroyed by this tool.

Returns full detail for one division in the connected organization.

Lists a division's seed proposal: the order its teams would be paired in. Each position is marked "stored" (a saved seeding) or "default" (the fall-back order the division has when nothing has been saved). A position with no team is a HELD (deliberately empty) position and comes back with a null program_team_id.

Lists divisions within a program in the connected organization.

Replaces a division's ENTIRE seed order in one call. `seeds` is the whole ordered list, position 1 first: send every position you want the division to have, not just the ones you are changing. A null program_team_id is a HELD (deliberately empty) position; to release a held position, leave it out of the next call; to reset the division to its default order, send an empty list. Teams entered in the division that the list does not name keep their default order after the ones it does. Every id is re-checked against the teams actually entered in this division, and a team entered in a different division is refused. This overwrites any order saved by someone else since you read it.

Updates a division's name, type, maximum number of teams, gender, who can sign up, sort order, or window override. Only the fields supplied are changed; omitted fields are left as they are.

Makes a file of one table of the connected organization — members, teams, rosters, registrations, schedule, standings (needs program_id) or payments — and returns a link to download it, good for 10 minutes. Format csv, xlsx (Excel), json or pdf (up to 2,000 rows). The file holds the rows the matching screen lists for the same filters, and needs the permission to view that screen; every export is recorded in the access log. Give the person the link; do not read the file out.

Creates a field under a location in the connected organization.

Computes a field's available windows (union of permits minus blackouts) across a date range, in the connected organization.

Lists a location's fields, in the connected organization.

Removes a field from a location. The first call previews and writes nothing; call again with the returned confirmation_token to remove it. Refused while games are still to be played there: move them first. Games already played keep it.

Renames a field of a location in the connected organization. Two fields of one location cannot share a name.

Assigns a referee (role official) or a crew member (role crew) to one or more games of a program, or clears that role when neither user_id nor organization_official_id is given. Name the person by user_id or by organization_official_id, not both. The person must hold the organization's "Can be assigned as referee" or "Can be assigned as crew" permission for the role. Someone already assigned to that role on a game is released. Published games email the person once with every game; draft games wait until they are published. A person who already works a game that overlaps one of these (45 minutes between different locations) is named in a validation error and nothing is assigned until you send the same call again with confirm_overlap true.

Accepts or declines a game you were assigned to as an official or crew member, or undoes your decline. answer is accept, decline or undo. Only the assigned person can answer; declining frees the game for someone else (a game you already accepted can be given back until 6 hours before it starts; add an optional reason only the organizer reads), accepting a game that overlaps one you already accepted is refused with a warning until you send the same call again with confirm_overlap true; and undo puts it back to waiting for your answer while nobody else has been assigned.

Sets the position a referee or crew member holds on one game, such as Assistant or Setup crew; their fee for that game follows the position. The position must be on the same side as the place: a Referee-side position for the referee, a Crew-side one for crew. Positions are listed by list-official-fees. Requires permission to assign referees and crew.

Returns the connected user's identity and the bounds of their own access: their acting organization, their role, the scope and expiry of each grant they hold, and the atoms they can actually reach, in sentences.

Writes a reviewed staged import into a contact list, one contact per row. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually import. It writes CONTACTS ONLY — a column read as the paid/unpaid state is read and staged; no payment is written, and no registration is created. Rows with no email address are skipped and recorded as skipped. An import can only be committed once. Ask the person, in their own words, what they told these people their email is for and where the list came from, and ask them to confirm each of the three statements; never answer these for them. A commit without all five is refused.

Stages a pasted roster or contact list for review in the connected organization. Nothing is imported by this call: it reads the text into rows and a proposed column mapping you can inspect and change, and writes no contacts. Accepted text is a CSV-like block with a header line, or a plain list of email addresses. There is no file upload on this surface — paste the file contents as text; an .xlsx sheet must be saved as .csv first. Call commit-staged-import to actually write the contacts.

Changes what one column of a staged import reads as — both retargeting a column Hollis already placed and promoting one it left out. Writes no contacts and never rewrites the staged rows: the mapping is an interpretation laid over the data, so it can be changed as often as you like. Refused once the import has been committed, because its mapping is then the record of how those contacts were read.

Adds a custom field (name and value) to a location. Set secret to true for a value that must be masked and revealed only through a logged reveal, like a gate code.

Creates a location (address, geo, and public detail) in the connected organization.

Returns full detail for one location, including its fields, in the connected organization.

Lists a location's custom fields (name and value). A secret field shows no value, and no tool reveals it: a person reveals it in Hollis, where the reveal is logged.

Lists locations in the connected organization.

Removes a custom field from a location. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it.

Sets (creates or updates) the access-block details for a location: permit/booking reference, site contact, after-hours number, gate code, light-panel code, and keyholder.

Changes a location's name, address, indoor/outdoor type, surface or area in the connected organization. Only the fields given change.

Changes a location custom field's name, value or secret flag. Only the keys you pass change.

Hides a player’s or captain’s message written to the organizers (from organizer-messages), or shows it again with hidden false. Hidden, it is gone from everyone’s Messages but its writer’s, who sees “Removed by the organizer”; emails already sent stay sent. Needs the right to send announcements.

Lists YOUR OWN messages in this organization, newest first: what your teams, their captains and the organizers wrote to you, and what you wrote. Each says who it went to, its conversation’s topic, whether it is new, and whether you can reply.

Lists the organizers’ messages: box inbox (default) is what players and captains wrote to the organizers, each thread with its replies; box sent is what organizers wrote to a team, division or program. Needs the right to send announcements.

Answers a message from my-messages. The reply reaches the same people as the message it answers, except an answer to an organizer’s message sent to many, which goes to the organizers only as its own conversation; an answer to an organizer’s message to one person stays in that conversation. Only someone the message was for, or who wrote it, can reply.

Writes a message to everyone on one team (to team), on every team in a division (to division), in a game (to game: both teams and its officials), to one member (to person), or to everyone in a current program plus staff (to organization). Or pass targets — a list of {to, id} — for one message to several at once; each person is emailed once. It shows in their Messages and is emailed. Needs the right to send announcements; a person or the organization needs it org-wide. Recipients may answer, and an answer goes to the organizers only; to one person alone, their answer stays in the same conversation. For a whole program use send-program-message.

Writes a message to everyone on a program’s teams: it shows in each player’s Messages under Program and is emailed. Needs the right to send announcements. Recipients may answer, and an answer goes to the organizers only. A program of more than 50 people asks for a confirmation first.

Writes a message for one of YOUR teams. audience is team (everyone on it), captains (its captain), player (one player: captains only, with recipient_user_id) or organizers (the organization’s organizers; share=true lets the rest of the team see it). It shows on Home and is emailed.

Records an absolute away window — a start date and an end date — for the connected user, for dates they will be unavailable to officiate. Both bounds are required and the end may not precede the start; a single-day window is allowed. This is for an absolute absence such as being out of the country, never for a standing preference. Refuses if the connected user is not an official here.

Adds a position for referees and crew, such as Line judge, on the Referee side or the Crew side. The side decides who may hold it: people who can be assigned as referee, or as crew. Refuses a name already in use. Requires the Pay referees and crew permission.

Starts connecting the connected user’s own bank account through Stripe so they can be paid as a referee or crew member, or, once connected, opens Stripe to change it. Returns a Stripe link for them to open in a browser. Only for referees and crew of this organization; moves no money.

Reads the organization’s agreement for referees and crew: whether officials are asked to sign it (asks), whether they must sign before accepting a game (sign_first), the current version and its text, and each referee or crew member with the version they signed, if any. Requires permission to change the organization’s settings.

Lists the organization’s positions for referees and crew and the fee per game for each: the organization default per position, each program’s own fee, and each game that has its own fee, and each game that pays a percentage above or below (percents). A game’s fee is its own, else its program’s, else the default, moved by the game’s percentage unless it is the game’s own; a changed fee applies to every game not yet paid. Requires the Pay referees and crew permission.

Lists what each referee and crew member is owed, game by game: the game, its date, the position they held and its current fee, for games they accepted and worked. Requires the Pay referees and crew permission.

Shows the connected user’s own bank account for getting paid as a referee or crew member: whether it is connected, and the bank’s name and last four digits. Only their own.

Lists the areas the connected user has declared they will officiate in, for this organization. Refuses if the connected user is not an official here.

Lists the connected user’s own fees as a referee or crew member, game by game: the game, its date, the position they held, the fee and whether it is owed. Only their own; nobody else’s pay.

Pays referees and crew what they are owed for games they worked: one debit from the organization’s bank account for the total plus Stripe’s fee, and each official’s share deposited once the debit clears (a few business days). Pass the official_id of each official to pay (from list-official-pay). Only games with a fee and officials with a bank account connected are paid. Requires the Pay referees and crew permission, and a human signed in to Hollis must approve it first: the first call returns an approval reference and URL; call again with approval_reference after a human has approved.

Removes one of the connected user's own absolute away windows, by its id. Refuses if the window belongs to another official, if it does not exist, or if the connected user is not an official here. Use my-coverage or add-my-away-window to see the current windows and their ids.

Removes a position for referees and crew. People who held it keep their games and their fee. Refuses the last position on the Referee side or the Crew side. Requires the Pay referees and crew permission.

Makes one game pay its referees and crew a percentage above or below their usual fee: +20 pays a fifth more, -10 a tenth less, for every position on that game. The percentage moves the program’s fee for the position, else its default; a fee set for that one game with set-official-fee is a price and is not moved. percent null (or 0) clears it. -100 to 500. A new percentage applies to every game not yet paid, and every referee or crew member with an unpaid place on the game whose fee changes is emailed the old and new amount a few minutes later (edits made close together are one email); notified_officials says how many. A game already paid keeps what it paid. Requires the Pay referees and crew permission.

Declares which areas the connected user will officiate in, replacing their current declaration. Pass an empty list to declare that they will work nowhere. Refuses if the connected user is not an official here, or if an area belongs to another organization.

Sets the fee per game for one position: the organization default (no program_id or game_id), one program’s own fee (program_id), or one game’s own fee (game_id). fee_cents null clears it, so a program or game falls back to the level above. A new fee applies to every game not yet paid. Requires the Pay referees and crew permission.

Changes the organization’s agreement for referees and crew. body: the organization’s own text; a changed text saves a new version, and everyone who signed an earlier version is asked to sign again. asks: whether officials are asked to sign it. sign_first: whether an official must sign the current version before accepting a game (off by default; needs asks on and a saved version). Send only what changes. Hollis supplies no wording. Requires permission to change the organization’s settings.

Cancels an invitation to join the organization that has not been accepted; its link stops working. The first call previews and writes nothing; call again with the returned confirmation_token to cancel.

Changes a member's role within the connected organization. `user_id` must be the exact numeric id of an existing member and `role_name` must be an exact, existing role name — never resolve an ambiguous or free-text reference (a person's name, or a role name you are inferring or inventing) yourself; if either is ambiguous, call `list-members` to confirm the member and ask the user for the exact role name. This action can remove authority as easily as grant it and takes effect only after a human signed in to Hollis has reviewed and approved it.

Creates a new role in the connected organization from a set of permission atoms. The role grants nothing until it is assigned to a member. A role with only player, captain, guardian, referee or crew permissions is one call; a role with any organizer permission needs a confirmation and then a human signed in to Hollis to approve it.

Creates a new organization owned by the connected user.

Deletes an org-defined role in the connected organization. A role that somebody currently holds is REFUSED, naming how many people hold it — reassign them first. Built-in roles cannot be deleted. `role_id` must be the exact numeric id of an existing role; call `list-roles` to confirm it rather than inferring one.

Reads the connected organization's sending identity: hostname, verification status, and (while pending) the DNS records still to add. Returns a null mail_domain if nothing has been provisioned yet, which is a normal state, not an error.

Invites a user to join the connected organization under a named role. Inviting someone to a player, captain, guardian, referee or crew role is one call. A role with organizer access (admin, staff, or a custom role with any organizer permission) needs a confirmation and then a human signed in to Hollis to approve it before the invitation is sent.

Lists pending invitations for the connected organization: invitee, role, scope and when the grant ends.

Lists members of the connected organization.

Lists the roles of the connected organization, with each role's permission-atom count and how many members hold it.

Provisions the connected organization's default sending subdomain, or (with custom_hostname) upgrades to a custom domain. Idempotent: re-running with no custom_hostname when a domain already exists is a no-op.

Revokes a member's access to the connected organization. `user_id` must be the exact numeric id of an existing member — never resolve an ambiguous or free-text reference (a name, an initial, "the new player") to a person yourself; if the reference is ambiguous, call `list-members` first and ask the user which member they mean. This action destroys data: it takes effect only after a human signed in to Hollis has reviewed and approved it, and cannot be undone by calling this tool again.

Replaces an org-defined role's name and permission atoms in the connected organization. `permission_atoms` REPLACES the role's whole set — atoms you omit are removed from the role, and every member holding it loses them immediately. Send the complete intended set, not a delta; call `list-roles` first if you are unsure what the role carries. Built-in roles cannot be changed — copy one instead with `create-custom-role`. Every change needs a confirmation; a role that carries organizer permissions after the change also needs a human signed in to Hollis to approve it.

Updates the bound organization's mail settings. Sets the physical postal address that United States CAN-SPAM law requires in every bulk announcement footer, and the address announcements are sent as on the organization's own domain.

Updates the bound organization's payment settings: refund approval, unpaid-registration hold duration, refund fees, the processing charge, and the default withdrawal terms (full-refund deadline and what is refunded after it). Only the fields supplied are changed; omitted fields are left as they are.

The organization's name, web address (slug — NAME.hollisapp.com; changeable only until its first program is published), sport (sports: a list from the fixed set; one unless multi_sport is true — a label, it gates nothing) and time zone (an IANA name every game time is shown in). Send only the fields to change.

Whether the organization asks players their gender (asks_gender; on by default, asked once and kept on the player, never collected when off), and whether a sub may play for more than one team in a program (subs_multiple_teams; on by default, one team only when off — never both sides of one game either way). Every organization takes players 18 and over only for now (adults_only, returned; it cannot be changed yet).

Re-checks DKIM and Return-Path verification for the connected organization's sending domain and reports the current status, including which check is still outstanding if verification has not completed.

Cancels an unpaid charge in the connected organization: its payment link stops working. The first call previews; call again with the returned confirmation_token to cancel.

Asks a member of the connected organization to pay an amount for something outside registration: emails them a payment link. The first call previews and writes nothing; call again with the returned confirmation_token to send it.

Lists the connected organization's payments, newest first: invoice, payer, amount, status, what went back to a card (refunded_cents) and as credit (credited_cents), and what it was for.

Starts payment of a charge the connected organization asked you to pay, via a Stripe-hosted Checkout Session. The first call previews; call again with the returned confirmation_token to get the checkout link.

Starts payment for your own registration via a Stripe-hosted Checkout Session. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually start the checkout.

Starts a bulk payment covering every payable registration on a program-team instance's roster, for one division, via a single Stripe-hosted Checkout Session. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually start the checkout.

Refunds a paid registration: by default a cancelled one for the whole of what is left; or, with kind, a withdrawal refund (the registration ends) or a partial refund. A real, external, hard-to-fully-undo financial transfer. Depending on this organization's settings, this either requires a single confirmation or a second human's approval before it happens. The first call moves no money: it returns a confirmation_token to repeat the call with, or opens an approval request (approval_reference) that a person must approve on the web before a repeat call refunds.

Emails an unpaid charge's payment link to its payer again. The first call previews; call again with the returned confirmation_token to send.

Creates a permit naming exactly one of a location or a field it covers, in the connected organization.

Returns full detail for one permit in the connected organization.

Lists a permit's change events (edits that narrowed a previously-granted window), in the connected organization.

Lists permits in the connected organization, soonest to expire first.

Sparse-updates a permit's valid_to/days/start_time/end_time/status, and which of its location's fields it covers (sub_location_ids; an empty list = the whole location), in the connected organization.

Reads a division's playoff seeds: the official standings order within the playoff cut, the seeds (that order unless an organizer reordered it), who changed what, and whether the playoffs have started. Program team ids, first seed first.

Moves a team up or down one playoff seed in its division (swapping with its neighbour). Recorded with who made it. Refused once the playoffs have started.

Puts a division's playoff seeds back in the official standings order. Recorded with who made it. Refused once the playoffs have started.

Starts a division's playoffs: locks the seeds, puts the seeded teams on the first round's games, and emails those teams' players their playoff games. Needs the schedule published. Asks for confirmation first.

Archives a program, hiding it from default lists and closing its registration gate. Destroys nothing (unarchive-program brings it back, as a draft) but is treated as destructive: the first call previews what would happen and writes nothing. If the program has divisions, this action also requires a human signed in to Hollis to review and approve it before it takes effect — call again with the returned confirmation_token, then again with the approval_reference that call returns, once a human has approved the request on the web. A program with no divisions only needs the confirmation step.

Copies an existing program in the connected organization into a new one, carrying its season shape, divisions structure, fee and roster rules. The copy is ALWAYS created as a DRAFT, whatever the source program's visibility was — publish it separately once it is ready. Registrants, teams, schedules and results are never copied.

Creates a new program (season) in the connected organization, starting in draft visibility.

Creates a new program from a program template in the connected organization. The template is COPIED, never linked: the new program keeps no reference to it, and editing either one afterwards does not affect the other. Any field you send overrides the template's value for that field.

Deletes a program (soft delete — nothing is permanently destroyed by this tool, but no restore surface exists in this phase). The first call previews what would happen and writes nothing. If the program has divisions, this action also requires a human signed in to Hollis to review and approve it before it takes effect — call again with the returned confirmation_token, then again with the approval_reference that call returns, once a human has approved the request on the web. A program with no divisions only needs the confirmation step.

Returns full detail for one program in the connected organization.

Invites email addresses to register for an invite-only program; each gets an email with their own link, and only invited addresses can register. Already-invited addresses are skipped. The program must be invite only (set-program-visibility with invite_only), unless division_id is given: then each address is invited to join that division as a free agent, on an open or invite-only published program alike. Nobody is registered by being invited: they open the link, sign in and register themselves, and the division's capacity of teams never refuses a number of people. With division_id, addresses already registered in the program, already invited, unsubscribed or undeliverable are skipped, each reported with its reason. Up to 200 at a time; more than 50 asks for a confirmation first, and an organization sends at most 500 emails an hour and 2000 a day across invitations and messages.

Lists who is invited to an invite-only program, and whether each has registered yet.

Lists programs in the connected organization.

Marks a published program Complete by hand (complete: true), overriding the status worked out from its games, or clears that mark (complete: false) so the status is worked out again. Not for drafts or archived programs.

Publishes a draft program to public or unlisted visibility, opening it up to accept registrations.

Removes an invited email from an invite-only program: their link stops working and they can no longer register. Someone already registered cannot be removed this way.

Sets who can see a program's page: "public" (listed on the organization's page) or "unlisted" (anyone with the link). On a draft it sets what the program will be published as; on a published program it changes it at once.

Brings an archived program back as a draft: nothing is open to players until it is published again. Registrations, teams, games and staff are untouched. Refused for a program that is not archived.

Updates a program's name, description, registration window or season shape, or flips its early-close switch. Only the fields supplied are changed; omitted fields are left as they are. Every field stays editable after publish. When a change leaves committed games that no longer fit (a game on a day, hour or field the program no longer plays, or outside its dates), nothing is refused and no game moves: the program is flagged and a task asks for the schedule to be regenerated. On a program with one game day, moving first_game_on to another weekday moves the game day with it.

Adds a new team, or a team that played before (team_id), to a division (or its wait list) in the connected organization and emails its captain an invitation to accept it. The team shows as awaiting captain until they do. Never discloses the invitation link.

Assigns or clears the captain of a per-program team instance in the connected organization.

Names or clears the co-captain of a per-program team instance: a second full captain (roster, payment, results) for that one team. Exactly one per team; naming another replaces the current one.

Chooses who pays for one team's entry. captain_pays true: the captain pays for the whole team (the division's roster minimum times the per-player price), which covers that many places, the captain's included; players who join after those pay their own share; a free agent placed on the team pays as usual and that money becomes the captain's credit, held until the season ends. false: each player pays their share (the default). Only the team's captain or co-captain, or someone who manages its roster, and only before anyone on the team has paid.

Creates a new team in a division from several of its free agents (registrations with no team): one of them, or another email address, is invited as captain, and every other one is emailed an offer of a place they must accept. Nobody is put on the roster by this call. Refused, with nothing sent, when the selection misses the division's roster minimum or maximum or a gender minimum. Never discloses a link.

Enters a persisted team into a program in the connected organization, creating a per-program team instance.

Returns full detail for one per-program team instance in the connected organization.

Lists teams entered into a program in the connected organization.

Lists the teams the connected user is on in this organization, and flags which ones they captain. Use this first to find a program_team_id for roster tools.

Removes a team's per-program instance from a program. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it. The removal is a soft delete of the instance and a hard delete of its roster entries — the underlying team and program rows are untouched. Registrations on the team with nothing paid, signed or not, are cancelled; each paid player becomes a task to refund or credit them (no money moves here; to settle one now, call refund-registration for their registration, under its own approval). Games not yet played keep their slot with a stand-in side, "Pending Team #N"; games already played keep the team's name and score.

Re-sends the captain invitation of an organizer-added team that is still awaiting its captain, with a fresh link valid for 7 days — or, with captain_email, invites another captain instead (required after the first one declined). Never discloses the link.

Resigns the caller's own captaincy (or co-captaincy) of a per-program team instance; they stay on the roster as a player. A captain with a co-captain hands over to them at once; a captain with none stays captain until the organizer names a new one, and the organizer is given a task.

Creates a reusable program template in the connected organization. A template holds a program's SHAPE only — no dates, no season, no people — and is copied into a new program at create time, never linked to one.

Removes a program template from the connected organization. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it. Programs already created from the template are NOT affected in any way — a program is a copy, never a link. The removal is a soft delete.

Lists the reusable program templates in the connected organization, optionally filtered by format, gender or length.

Saves an existing program's shape as a reusable program template. Carries the game shape, gender rules, fee, team maximum and relative registration offsets — never the dates, the registration window, the visibility, or anyone registered. The program itself is unchanged and is not linked to the template afterwards.

Edits an existing program template in the connected organization. Only the fields you send are changed; everything else is left exactly as it was.

Accepts the connected user's own waiver for one of their pending registrations, completing it. The first call previews the waiver text and writes nothing; call again with the returned confirmation_token to actually accept it.

Cancels a registration. Destroys nothing irreversibly (the row remains as a historical record): the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually cancel it.

Gives an unpaid registration more time to pay: its payment hold runs for the organization's hold length from now. A lapsed hold keeps its spot until an organizer extends it or releases the spot with cancel-registration.

Returns full detail for one registration in the connected organization.

Lists the free agents in one division: players registered who are not on a team yet, with their waiver and payment state and when they registered. A player's email is included only if you can view members. Use offer-placement to place one on a team.

Lists registrations in the connected organization, optionally filtered by program_id, division_id, or status.

Moves the connected caller's own registration — or, for an organizer, any registration in this organization — to a different division of the SAME program. Does not require confirmation: it changes an existing row's division, never creating or cancelling one.

Moves every active registration on a program-team instance's roster to a different division of the SAME program, in one call. Does not require confirmation: it changes existing rows' division, never creating or cancelling one.

Moves a team off its spot in a division and back onto that division's wait list, freeing the spot. Anyone on the team who has paid is refunded what is left of their payment in the same act. Refused once the season has started. The first call moves nothing: it returns a confirmation_token, or, when it refunds and the organization requires approval for refunds, opens an approval request (approval_reference) that a second person must approve on the web before a repeat call goes ahead.

Lists YOUR OWN open placement offers: teams that have offered you, a free agent, a place (or, with moves_from_team_name set, a move off the team you are on), and when each offer closes. Where a place has a price, accepting it means paying it by that same time (expires_at): there is one deadline to accept and pay. A move to a team in another division carries price_difference_cents, what accepting changes in your price (positive costs more, negative costs less and is given as credit if you have paid, 0 nothing); null on a place offered to a free agent.

Lists the registrations belonging to the connected user in this organization.

Offers a free agent (a registration with no team) a place on a team in their division. The player is emailed and has 24 hours to accept or decline; nothing changes on the roster until they accept. Never discloses the offer link.

Offers a player who is on a team a move to another team of the program, in their division or another. The player is emailed and has 24 hours to accept or decline; they stay on their current team until they accept, and accepting moves them in one step. A move to a team in another division can change what they owe, and the offer states the amount before they accept (price_difference_cents: positive costs more, negative costs less, 0 nothing; it also says source_team_left_empty: true when nobody else would stay on the team they leave, the move still going through): an unpaid place is re-priced and paid the usual way, a paid place that costs more is charged the difference with a pay link, and either way the player has seven days from accepting to pay, while one that costs less is given the difference as credit, never to the card. A move to or from a team that pays its whole entry is refused, as is moving a captain or co-captain. Never discloses the offer link.

Promotes a waitlisted registration into its division. Destroys nothing: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually promote it.

Registers the connected user for a division in the connected organization, accepting the current waiver.

Registers every player on a program-team instance's roster into a division of the connected organization. Each player enters a pending-waiver state and must accept their own waiver individually (see accept-waiver) before their registration is confirmed.

Accepts or declines one of YOUR OWN placement offers (see my-placement-offers). Accepting puts you on the team's roster; where the place has a price, you pay it by the offer's own expiry (pay_by), the same deadline you had to accept, and the place is held for you until then. Declining keeps you in the free-agent pool, and that team cannot offer again this program.

Changes the connected user's own answers to a program's registration questions, and their gender, on one of their registrations.

Withdraws the caller from one of their own registrations, up to the full-refund deadline they were shown when they signed up; after it only an organizer can withdraw them. What was paid is refunded in full: refund_to card sends it back to the card that paid, less the processing charge where the league keeps it on refunds; credit gives all of it as credit for a later registration, nothing kept back (only when the caller paid it themselves). A place someone else covered, or one not paid yet, is released and nothing is refunded. The first call previews what would happen and writes nothing; repeat it with the confirmation_token it returns.

Adds a question to the organization's registration library. answer_type is choice (pick one), several (pick several), text, long_text, number, phone, email, yes_no or date; choice and several take two or more options, the others none. Left out, options make it a choice and no options make it text. A program then asks it through update-program's `questions`.

Lists the organization's registration question library: id, label, answer_type (choice (pick one), several (pick several), text, long_text, number, phone, email, yes_no or date), options (a choice's or several's answers; null otherwise) and retired (a program can't pick a retired question). A program asks some of them — set with update-program's `questions`.

Rewords a library question, changes its answer_type (choice (pick one), several (pick several), text, long_text, number, phone, email, yes_no or date) or its options, or retires it (retired true) or brings it back (false). Every program asking it asks the new wording from the next registration; earlier answers keep pre-filling because the question keeps its identity. A retired question cannot be picked by a program; programs already asking it keep asking it. Position and Skill level are always choice.

Adds a player to one program-team instance's roster in the connected organization. The player must already be a member of this organization.

Invites players from last season's roster to the team you captain, each from you; every one answers for themselves and nobody is placed, paid or signed until they do. Pass user_ids from list-bring-back-players, or none to invite everyone offered. Captain only. Never discloses the invitation links.

Takes back an invitation to a program-team instance's roster that nobody has accepted; its link stops working. The first call previews and writes nothing; call again with the returned confirmation_token to cancel.

Issues a team invitation to one program-team instance's roster in the connected organization. Never discloses the invitation link.

Lists the players the captain of a team could bring back from its last season: the people on the roster of the newest earlier season of the same team that this captain led, not already on a team in this program or invited to this one. Each row carries the user_id bring-back-players takes. Captain only; empty when nobody is left to offer.

Lists organization members who could be added to one program-team instance's roster in the connected organization — members not already rostered anywhere in that program.

Lists every program-team instance with a roster in the connected organization. An atom holder (rosters.view) sees every instance; an attached-only caller (captain or rostered player) sees only the instance(s) they are attached to.

Lists the players on one program-team instance's roster in the connected organization.

Lists the invitations sent to join a team, for one program (program_id) or one team (program_team_id): who was invited, whether it is pending, accepted, cancelled or expired, and when. Optionally narrow by status. Each row carries the invitation_id cancel-team-invitation takes.

Puts a player who was removed from a team back on its roster, with the registration the removal cancelled (if it has not changed since) and the captain or co-captain role the removal cleared (if nobody holds it now). Refused while the player is on another of the program's teams.

Removes a player from a program-team instance's roster. Their registration on that team is cancelled with it when nothing is paid, signed or not; a paid registration, or one with a checkout in progress, is left for the organizer. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove the player.

Says whether you are playing a game: answer is yes or no, with an optional reason on a no. Only a player on one of the game’s two rosters can answer, only for themselves, and only before kickoff. Answers can be changed. No answer counts as not playing.

Lists who is playing a game: per team, how many said yes, no, or have not answered (which counts as no), whether the team is at forfeit risk, and each player’s answer and check-in. You see only the teams whose roster you may read.

Emails the RSVP ask again to players on one team of a game who have not answered. Without user_ids, everyone on the team who has not answered is asked. Needs the team’s captain or permission to manage rosters.

Promotes a division's draft games to committed, making the schedule visible to players and ready to distribute. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually commit it. You can still edit, add, or remove individual games afterward. Refused while the program is still draft: publish the program first.

Adds one game to a division's schedule. Both teams must already be entered in that division.

Marks a cancelled game in the make-up queue as not made up and gives each paid player their share of the fee (fee divided by their team's games) as credit, which comes off their next registration and lasts a year. Depending on this organization's settings it needs a single confirmation or a second person's approval; the first call changes nothing: it returns a confirmation_token, or opens an approval request (approval_reference) that a person must approve on the web before a repeat call goes ahead. A refund cannot be decided here: a person decides it on the Schedule tab, or you use refund-registration per player.

Removes a game from a division's schedule. A published game is cancelled with a reason (Location, Team, Officials, Weather, or Other with a note) and goes to the make-up queue; make it up with schedule-makeup. Destroys nothing outside Hollis: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually remove it. Cancelling a game is recoverable by adding it back — it is a status flip, not a permanent delete.

Distributes a division's committed schedule by emailing it to every non-suppressed contact on one of the connected organization's contact lists. A real, external, hard-to-fully-undo mail delivery under the organization's own sending domain — there is no unsend. The division must already have a committed schedule (generate and commit one first). This action takes effect only after a human signed in to Hollis has reviewed and approved it, and cannot be redeemed a second time for a different division, a different list, or a schedule that has since changed.

Emails each registered player in a division their own team's published games (one email per person, transactional). Use after publishing the schedule; returns how many people were emailed. Refused while the program is still draft.

Generates or regenerates a round-robin schedule for a division. Refused, with nothing written, when the rounds need more weeks than a weeks_of_play a person set; the refusal says by how much and what to change. While weeks_of_play follows the published schedule, a regenerate that makes the season longer is not refused and its confirmation says how many weeks longer and the new end. Never places a game today or earlier: placing starts on the first game day after today, games already played (today and before, not cancelled or held) are kept and count toward the round robin, and the confirmation says how many stay and where placing starts. A first generation (no existing games) writes immediately. Regenerating replaces every generated game with a newly generated set, but preserves games you added or edited by hand and cancelled games, so it needs a confirmation round-trip first; with only_missing every placed game stays and only the games without a slot are placed again. The confirmation lists the games the run writes, and a plan the run would refuse is refused before a confirmation token is issued. Regenerating a schedule already sent to registrants additionally needs a human signed in to Hollis to approve it — call again with the returned confirmation_token, then again with the approval_reference that call returns, once a human has approved the request on the web.

Returns full detail for one game in a division's schedule.

Lists a division's games, ordered by round then scheduled time. Optionally filter by status (draft, committed, or cancelled).

Lists every fixture in the connected organization, ordered by date then round. An atom holder (divisions.view) sees every non-cancelled game; an attached-only caller (captain or rostered player) sees only their own team's committed fixtures.

Lists the upcoming committed games for the teams the connected user is on in this organization. Shows nothing for someone not on a roster.

Pins a game so regenerating the schedule keeps it where it is (pinned: true), or releases it so the next regenerate may move or replace it (pinned: false). A game added or edited by hand is already pinned. Held and cancelled games are refused.

Schedules a make-up for a cancelled game waiting in the make-up queue: a new game between the same two teams at the given time and field. The cancelled game stays, marked made up. Refused for a game not in the queue.

Updates a game's round, scheduled time, or either team, or keeps it where it is although it does not fit the program's settings. Only the fields supplied are changed; omitted fields are left as they are. Both teams must already be entered in the division. Moving a game onto a day an assigned referee or crew member is away takes them off it: that first call previews who comes off and writes nothing; call again with the returned confirmation_token to move it. A game that needs a place (status held) is placed by giving it sub_location_id, scheduled_at and duration_minutes together, and nothing else about it can be changed until then; once placed it is a draft until the schedule is published again, and teams who had it keep seeing Time TBD until then.

Emails the official assigned to a game that has started and has no score, asking for the score with a link to enter it. Recorded in the program history. At most once an hour per game.

Confirms a score the other team's captain entered, so it counts in the official standings. Only the opposing captain or organization staff may confirm; a disputed result is settled by the organizer instead. Unanswered results confirm themselves after 24 hours.

Returns a division's league table AND the fixtures it is still missing, from one call: ranked rows with played/won/drawn/lost, goals, goal difference and points; the unscored fixtures by name; and the played/total figures the header states. Three points for a win, one for a draw. A fixture that was cancelled or not played contributes nothing and is not counted as missing. Nothing is assumed for a game with no result — it is listed, never scored as a nil-nil.

Lists every committed fixture in this organization whose kickoff has passed and which has no result recorded — the work queue behind "record the result". Ordered by kickoff, earliest first. A fixture that was cancelled, or that already carries a terminal disposition (forfeit, abandoned, not played), is RESOLVED and does not appear here. Use record-game-result or record-game-disposition to clear one.

Raises a dispute against a RECORDED result, stating what is being disputed. The result itself is NOT changed and stays live in the standings until somebody settles the dispute and separately re-records the score. A result may carry only ONE open dispute at a time — settle the open one before raising another. A dispute with no stated reason is refused, because it cannot resolve to an outcome.

Records what happened to a fixture that produced NO played score: forfeit, abandoned, not_played or cancelled. There is no default — name one. Use record-game-result for a game that was played; this tool refuses `played`. A forfeit needs forfeit_winner (home or away) and the score is decided by Hollis, not by you. Only an abandoned game may carry scores. Recording a second time OVERWRITES the stored result and keeps the previous one in the revision history, attributed to you.

Records the PLAYED score for a fixture — the two teams turned up and the game finished. If the game did not produce a score (forfeit, abandoned, not played, cancelled) use record-game-disposition instead; this tool refuses a disposition and that tool refuses a score. Recording a second time OVERWRITES the stored result and keeps the previous one in the revision history, attributed to you; pass `reason` to say why. A cancelled fixture has no played result.

Removes a game's recorded result, so the game reads as unscored again in standings and the unscored queue. Its history is kept. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to remove it. Refused while the result is disputed.

Settles an OPEN dispute to a stated outcome: upheld, rejected or withdrawn. A settlement is FINAL — it cannot be revised, and settling an already-settled dispute is refused. Upholding a dispute does NOT change the score: if the result is wrong, record it again with record-game-result, which is a separate act with its own attribution and its own revision entry. A settlement with no stated outcome is refused.

The caller takes a place a sub call offers, if they are on that division's bench, not on either team in the game, and the call is not yet filled. They are recorded as a sub for that game and team, and the team's captain and co-captain are emailed. Use pay-sub-fee to pay now, or they pay the referee at kickoff.

Calls the division's bench for substitutes for one published game that has not started, for one team, as many as it is short of the game-ready minimum by yes RSVPs. Only the team's captain or co-captain, or someone who manages its roster. Each person on the bench is emailed, in the order they joined, with the per-game fee and a one-tap link; the first to accept fill the places.

Puts the caller on a division's on-call bench of substitutes. They accept the program's waiver and that a sub pays the per-game fee, now or to the referee at kickoff. When a team is short for a game, its captain can call the bench, earliest joiner first.

Takes the caller off a division's on-call bench. A game they already agreed to sub in is unchanged.

Returns the divisions whose bench the caller is on, the open sub calls to those benches for games not yet started, and the games the caller is subbing in with whether their fee is paid.

Starts paying the caller's own per-game sub fee online and returns a checkout_url to send them to. A second call returns the same checkout while it is open. Paying the referee at kickoff is also allowed.

Switches automatic sub calls on or off for one team. When on, if the team is short of the game-ready minimum by yes RSVPs 48 hours before a game, the division's bench is called in the captain's name, as if the captain had pressed Call subs. Off by default. Only the team's captain or co-captain, or someone who manages its roster.

Closes a task. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually close it.

Creates an ad-hoc task with no feeder behind it.

Deletes a task a person added. Tasks from Hollis cannot be deleted; they clear themselves when fixed. The first call previews and writes nothing; call again with the returned confirmation_token to delete.

Dismisses a task. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually dismiss it.

Lists the tasks you can act on in the connected organization: your own tasks and the ones Hollis raises (a lapsed payment hold, a team without a captain, a game with no result). Each row carries the feeder_key and subject_key that close-task, dismiss-task and snooze-task take. Optionally narrow by tab (open, mine, hollis, done) or category.

Puts a task back on the open list: a snoozed task before its snooze ends, or a person's own (ad-hoc) task that was marked done. Who closed it stays on record. A task raised by Hollis stays closed once closed, and a dismissed task stays dismissed.

Snoozes a task until a date or event. The first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually snooze it.

Changes a task a person added: its title, note, reminder date, who it is assigned to, or its category. Only the fields you send change; send null to clear one.

Creates a persisted team in the connected organization. A team belongs to no program until entered into one.

Retires a team from the organization. Destroys data: the first call previews what would happen and writes nothing; call again with the returned confirmation_token to actually retire it. The retirement is a soft delete — nothing is permanently destroyed by this tool, and its per-program history rows are soft-deleted along with it. Registrations on those with nothing paid, signed or not, are cancelled; each paid player becomes a task to refund or credit them (no money moves here; to settle one now, call refund-registration for their registration, under its own approval). Games not yet played keep their slot with a stand-in side, "Pending Team #N"; games already played keep the team's name and score.

Returns full detail for one team in the connected organization, including every program it has entered.

Lists persisted teams in the connected organization.

Renames a team. Only the fields supplied are changed; omitted fields are left as they are. The team's slug never changes as a result of this call.

Computes the classified, priced location-hour utilisation ledger (booked/empty/blacked-out/wasted-in-prime), rolled up by area, in the connected organization. A draft game books its hour (draft: true on the segment), so a schedule read before publish shows the plan.

Adds a waiver to the organization at version 1. With is_default true it becomes the default, which every program without an assigned waiver asks registrants to accept. Hollis records acceptance of the text; it is not an e-signature product.

One of the organization's waivers: its current text and version, and the text of every earlier version (an acceptance records the version it accepted).

Lists the organization's waivers, the default first: id, name, current version and whether it is the default. A program uses its assigned waiver, or the default when none is assigned. Use get-waiver for the text.

Renames a waiver, changes its text, or makes it the default. A changed text is a NEW VERSION: earlier versions and the acceptances recorded against them are kept, and registrants accept the new version from their next registration. The default cannot be un-set directly; make another waiver the default instead.