Exposure Events

Step 2 of 2: removes one or more venues from the signed-in director's own events (the venue stays in the director's own list). Needs the confirmationToken from prepare_delete_event_venues for exactly the same ids - call that first and show the user what it lists. Rejected (nothing removed) if any of the venues' courts still has a game on it - remove those games first. At most 50 venues per request. Only works for events the director owns.

Step 2 of 2: removes one or more dates from the schedule of the signed-in director's own events, together with the date's empty time slots. Needs the confirmationToken from prepare_delete_schedule_dates for exactly the same dates and scheduleVersion - call that first and show the user what it lists. At most 50 dates per request. Rejected (nothing removed) if any of the dates has a game with teams on it - remove those games first. Needs scheduleVersion; refused if someone else changed the schedule since you loaded it. All dates must be on the same event. Only works for events the director owns.

Step 2 of 2: deletes one or more of the signed-in director's own standings groups (pools), including their team positions. Needs the confirmationToken from prepare_delete_standings for exactly the same ids - call that first and show the user what it lists. Rejected (nothing deleted) if any pool still has games - remove those games first. Teams are not deleted, only taken out of the pool. At most 50 groups per request. Only works for events the director owns.

Step 2 of 2: deletes one or more of the signed-in director's own registered teams. Needs the confirmationToken from prepare_delete_teams for exactly the same ids - call that first and show the user what it lists. If a team still has a scheduling credit applied and its refund window has expired, the whole request is rejected (nothing is deleted) rather than skipping that team - set its status to Inactive instead. At most 50 teams per request. Only works for events that director owns.

Step 2 of 2: removes the empty time slots (slots with no teams in them) from a date on the schedule of the signed-in director's own events, optionally only between FirstGameTime and LastGameTime and/or only for some courts. Slots that already have a game with teams are never removed - take those games out first. The date itself stays on the schedule (use delete_schedule_dates to remove it). Needs the confirmationToken from prepare_delete_time_slots for exactly the same dates, ranges and scheduleVersion - call that first and show the user what it lists. At most 50 dates and 500 time slots per request. Needs scheduleVersion; refused if someone else changed the schedule since you loaded it. All dates must be on the same event. Only works for events the director owns.

Gets the real, valid age group and grade values a team's Age/Grade fields can be set to (via add_teams/update_teams). A fixed, site-wide reference list - not scoped to any one event or division. Call this instead of guessing a value for Age/Grade; pass the exact Name back, e.g. "14U" or "8th Grade".

Gets the visible divisions (active and inactive) for one of the signed-in director's own events. Needed to find a valid division id before calling add_teams/update_teams, or before calling update_divisions/delete_divisions to manage the divisions themselves. Only works for events that director owns.

Gets the venues attached to one of the signed-in director's own events, each with its courts (the court id is what a game's court is set to) and the game window and time increments used to schedule on them. Only courts for the event's sport are returned. Use get_venues for the director's own venue list. Only works for events that director owns.

Gets the signed-in director's active events for one season, optionally filtered by event type, participation type, age group, or gender. By default only upcoming events are returned (events that have not ended yet). To see past events, or any other period, give startDate and/or endDate: then the events that take place within that date range are returned instead - an event counts if any part of it falls in the range. A date range can be at most one year. Events are listed by start date. Only returns events tied to that season - events not attached to any season won't appear. Call get_seasons first to find valid season ids.

Gets the final place (1st, 2nd, 3rd...) of every team in each division of one of the signed-in director's own events. A team's place is, in this order: the place entered for it on the Teams > Rankings page (PlaceType Division), else the place its bracket game gave it (PlaceType Bracket, PlaceName the bracket, e.g. Gold), else - in a division with one pool and no bracket, once the pool is finished - its place in the pool standings (PlaceType Pool, PlaceName the pool). Each team has its team id and its parent team id (the persistent team record that stays the same across events). Empty values are left out: a team with no Place has none yet - its bracket or pool is not finished, or the division has several pools and no bracket so there is no single order. Teams that tie share a place. Optionally limited to one division. Only works for events that director owns.

Gets games for one of the signed-in director's own events, optionally filtered by division, team, date (single day or a range), game status, or venue. ScheduleVersion is the schedule's version at the time of the read - pass it to any tool that changes the schedule; it is refused if someone else changed the schedule in the meantime. Only works for events that director owns.

Gets team rankings for one of the signed-in director's own seasons, optionally filtered by division. Rankings are pre-computed by a background job, not calculated here. Only works for seasons that director owns.

Gets the schedule status and setup for one of the signed-in director's own events: whether the schedule, standings, brackets and teams are currently shown on the event's own page on the Exposure Events website, how many games are scheduled versus still unscheduled (no date yet), and the schedule's time setup - default time increments (minutes), default first/last game time, and the scheduled dates with their own first/last game times. ScheduleVersion is the schedule's current version - pass it to any tool that changes the schedule (dates, time slots, games); it is refused if someone else changed the schedule in the meantime. Only works for events that director owns.

Gets the signed-in director's seasons (needed to look up rankings, which are scoped per season, not per event).

Gets the standings for one of the signed-in director's own events, grouped by division, with each standings group's (pool's) id, name, and team positions (position number, team, or the parent standing/seed a position is fed from). Each team also has its record - place (its ranking in the pool), games played, wins, losses, ties, points or winning percentage, scored, allowed and differential - calculated from the pool games' results with the event's tie-breaker rules, matching the website's standings report; Rules lists the tie-breakers in order and Complete says whether the pool's games are all played. Optionally limited to one division. Standings groups are what pool-play games are built from. Only works for events that director owns.

Gets a team's roster (players and coaches, including each coach's email and phone) for a team registered in one of the signed-in director's own events. Only works for events that director owns.

Gets teams registered (division, payment status) for one of the signed-in director's own events, optionally filtered by registration status, payment status, or division gender. Returns each team's id, needed to call get_team for that team's roster and coach contact info, the team's own gender, and its parent team id (ParentTeamId) - the persistent team record that stays the same across events, so the same team can be matched across events; null when the team has no parent record, for example a team a director added by hand. Only works for events that director owns.

Gets the time slots of the schedule grid of one of the signed-in director's own events: every date, time and court, and whether a game has been placed in it yet. By default only the empty slots (no game placed) are returned - the ones games can still be placed into; set onlyEmpty to false to also see the slots that hold a game (use get_games for those games' details). Optionally limited to one date and/or some courts. At most 500 slots are returned: Total says how many matched and Truncated whether some are missing - narrow it with date or courtIds. ScheduleVersion is the schedule's version at the time of the read - pass it to any tool that changes the schedule; it is refused if someone else changed the schedule in the meantime. Only works for events that director owns.

Gets the signed-in director's own venues (their saved venue list, not tied to any event), each with its courts. The venue id is what add_event_venues attaches to an event. Use get_event_venues to see the venues already attached to an event. Lists venues for all sports unless eventId or sportId narrows it.

Step 1 of 2 for deleting divisions. Deletes nothing: lists exactly which of the signed-in director's own divisions delete_divisions would delete (with their team and game counts) and returns the confirmationToken that delete_divisions needs. Show the list to the user and wait for their clear yes before calling delete_divisions. Rejected, like delete_divisions, if any division still has games scheduled or a team with an active scheduling credit. At most 50 divisions per request. Only works for events the director owns.

Step 1 of 2 for removing venues from events. Deletes nothing: lists exactly which venues delete_event_venues would remove from the signed-in director's own events (with their courts) and returns the confirmationToken that delete_event_venues needs. Show the list to the user and wait for their clear yes before calling delete_event_venues. Rejected, like delete_event_venues, if any of the venues' courts still has a game on it. At most 50 venues per request. Only works for events the director owns.

Step 1 of 2 for removing dates from a schedule. Removes nothing: lists exactly which dates delete_schedule_dates would remove from the signed-in director's own event (with how many empty time slots go with each) and returns the confirmationToken that delete_schedule_dates needs. Show the list to the user and wait for their clear yes before calling delete_schedule_dates. Needs scheduleVersion, like delete_schedule_dates, and the confirmationToken is only valid for that version. Rejected, like delete_schedule_dates, if a date has a game with teams on it. All dates must be on the same event, at most 50 dates per request. Only works for events the director owns.

Step 1 of 2 for deleting standings groups (pools). Deletes nothing: lists exactly which of the signed-in director's own standings groups delete_standings would delete (with the teams positioned in them) and returns the confirmationToken that delete_standings needs. Show the list to the user and wait for their clear yes before calling delete_standings. Rejected, like delete_standings, if any group still has games. At most 50 groups per request. Only works for events the director owns.

Step 1 of 2 for deleting teams. Deletes nothing: lists exactly which of the signed-in director's own registered teams delete_teams would delete (with their division and whether a scheduling credit would be refunded) and returns the confirmationToken that delete_teams needs. Show the list to the user and wait for their clear yes before calling delete_teams. Rejected, like delete_teams, if a team's scheduling credit refund window has expired. At most 50 teams per request. Only works for events that director owns.

Step 1 of 2 for removing empty time slots. Removes nothing: lists exactly how many empty time slots delete_time_slots would remove from each date of the signed-in director's own event (and how many slots with teams stay) and returns the confirmationToken that delete_time_slots needs. Show the list to the user and wait for their clear yes before calling delete_time_slots. Needs scheduleVersion, like delete_time_slots, and the confirmationToken is only valid for that version. All dates must be on the same event, at most 50 dates and 500 time slots per request. Only works for events the director owns.

Updates one or more of the signed-in director's own divisions. Only the fields provided per division are changed - fields left out are unchanged, matching a partial edit of the real Edit Division form. Setting Active to false is rejected for any division that still has games scheduled - remove those games first. Only works for events that director owns.

Updates the visibility settings for the schedule, standings, brackets and teams of one of the signed-in director's own Exposure Events events. These settings are stored within Exposure Events and nothing is sent to any other system or service. Changes apply event-wide, across all divisions. Only settings explicitly provided are changed; omitted settings keep their current values. This tool updates these settings only and does not modify games, game times, courts, teams, brackets, standings data, or other schedule content. It can only be used for events owned by the authenticated director.

Updates one or more venues attached to the signed-in director's own events: the game window, time increment and order, and optionally individual courts (turn on/off, rename, change times). Only the fields provided are changed - fields left out are unchanged. At least one court must stay active, court names and abbreviations must stay unique within the venue, and a court that already has games can't be turned off - remove those games first. The whole request is rejected (nothing saved) if any item is invalid. Only works for events that director owns.

Updates one or more dates on the schedule of the signed-in director's own events. Only the fields provided are changed - fields left out are unchanged, matching a partial edit of the real Edit Date dialog. NewDate moves the date, and is rejected if the date already has games - remove those games first. The whole request is rejected (nothing saved) if any item is invalid. Needs scheduleVersion; refused if someone else changed the schedule since you loaded it. All dates must be on the same event. Only works for events that director owns.

Updates one or more of the signed-in director's own standings groups (pools). Only the fields provided per group are changed - fields left out are unchanged. Providing TeamIds replaces the pool's whole team list in position order, and is rejected if the pool already has games - remove those games first. Names must stay unique within the division, and a team can only be in one pool of its division. The whole request is rejected (nothing saved) if any item is invalid. Only works for events that director owns.

Updates one or more of the signed-in director's own registered teams. Only the fields provided per team are changed - fields left out are unchanged, matching a partial edit of the real Edit Team form. If the caller only asks to change one thing (e.g. mark paid and inactive), change only that - never ask for or require any other field. Only works for events that director owns.