Gym

Archive a program — it disappears from the schedule and program pickers across the app, though its classes, enrollments, belt ladder and history all remain and it can be restored later with gym.update_program. Asks for confirmation because members and staff stop seeing it immediately. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.archive_program \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_archive_program at https://app.chirply.io/api/mcp, same bearer token, same input.

The attendance overview: total check-ins and distinct members this calendar week (Sunday start) and this calendar month (totals in UTC), plus the going-quiet list the attendance screen and dashboard show — actively enrolled members with no check-in in more than 14 days, each with their last-seen date, days quiet, usual training cadence (check-ins per week over the 8 weeks before they stopped), belt, and a tier: 'quiet' (15–30 days silent, most saveable, listed first) or 'gone' (30+ days, or never seen despite being enrolled 30+ days). Sorted most-saveable first — these are the people worth a retention call before they cancel. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.attendance_report \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "program_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_attendance_report at https://app.chirply.io/api/mcp, same bearer token, same input.

Record that a member attended — the same thing the lobby kiosk does when they tap their name. Recorded with source 'api' and the class name snapshotted onto the record. If the member is already checked in to that class today, this reports success with an already-checked-in note instead of failing, so double-taps are harmless. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.check_in_member \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_check_in_member at https://app.chirply.io/api/mcp, same bearer token, same input.

Check-ins per class over a trailing window (default 30 days), busiest first — each class with its total check-ins, distinct members, and program. The attendance screen's Classes tab. Deleted classes still appear under their snapshotted name, and free check-ins roll up as 'Open mat / general check-in'. Use it to spot which slots fill the room and which are dying. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.class_popularity \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "days": 30
  }'

Over MCP the same operation is the tool gym_class_popularity at https://app.chirply.io/api/mcp, same bearer token, same input.

Add one rank to a program's belt ladder. Minimums are advisory eligibility hints shown to instructors — they never hard-block a promotion. Appends to the end of the ladder unless a sort_order is given. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.create_belt_rank \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "program_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "name": "Example",
    "color": "example"
  }'

Over MCP the same operation is the tool gym_create_belt_rank at https://app.chirply.io/api/mcp, same bearer token, same input.

Add a recurring weekly class to the schedule — it repeats every week at its start time and appears on the schedule and the check-in kiosk immediately. Pass days_of_week to put the same class on several days at once ('Mon/Wed/Fri 6:30 PM'), exactly like the schedule editor's day checkboxes: one class row is created per day. day_of_week remains for a single day. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.create_class \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example",
    "start_time": "example"
  }'

Over MCP the same operation is the tool gym_create_class at https://app.chirply.io/api/mcp, same bearer token, same input.

Create a training program. Optionally seed its belt ladder from a preset (BJJ adults/kids, Karate/TKD, or generic levels) so ranks with real class/time requirements exist immediately; without a preset the ladder starts empty and ranks are added one by one. Creates only records inside this account — nothing outward-facing. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.create_program \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example"
  }'

Over MCP the same operation is the tool gym_create_program at https://app.chirply.io/api/mcp, same bearer token, same input.

Permanently delete a rank from a program's ladder. This cannot be undone. Members currently holding it are left with no rank (fix them with gym.update_enrollment), and past promotions to it keep their history but lose the rank name. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.delete_belt_rank \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_delete_belt_rank at https://app.chirply.io/api/mcp, same bearer token, same input.

Permanently remove a class from the weekly schedule. This cannot be undone; members can no longer check in to it. Past check-ins keep the class name as a snapshot, so attendance history survives. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.delete_class \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_delete_class at https://app.chirply.io/api/mcp, same bearer token, same input.

Enroll a CRM contact in a program as a training member. Unless a starting rank is given, they start at the first belt of the program's ladder (worn on day one). A contact can hold one enrollment per program; enrolling again returns a conflict rather than a duplicate. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.enroll_member \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "program_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_enroll_member at https://app.chirply.io/api/mcp, same bearer token, same input.

Get the check-in kiosk URL for the lobby tablet. TREAT IT LIKE A KEY: anyone holding this link can open the kiosk with no login and check any member in (or see the member roster the kiosk shows). Links stay valid until rotated with gym.rotate_kiosk_link. Creates the gym's settings row on first use. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.get_kiosk_link \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool gym_get_kiosk_link at https://app.chirply.io/api/mcp, same bearer token, same input.

List belt ranks in ladder order (lowest first), each with its color and the class/time-in-grade minimums required to earn it from the rank before. Filter to one program to see that program's ladder. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_belt_ranks \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_belt_ranks at https://app.chirply.io/api/mcp, same bearer token, same input.

List check-ins, newest first — who attended, which class (name preserved even if the class was later deleted), the date, and whether it came from the kiosk, staff, or the API. Filter by member, class, a date range, or a free-text member search (name, business, or email — the attendance log's own search box). Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_checkins \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_checkins at https://app.chirply.io/api/mcp, same bearer token, same input.

The weekly recurring class schedule, ordered by day then start time — each class with its day of week (0 = Sunday … 6 = Saturday), start time, duration, instructor, location, capacity, and program. These are recurring weekly slots, not calendar events. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_classes \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_classes at https://app.chirply.io/api/mcp, same bearer token, same input.

List the gym's members — each enrollment with the member's name and contact details, the program, their current belt rank and stripes, and status. Filter by program, enrollment status, current rank, or a free-text name query (same matching as the kiosk's member search). Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_members \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_members at https://app.chirply.io/api/mcp, same bearer token, same input.

List the gym's training programs (BJJ, Muay Thai, Kids Karate…) with their colors and active/archived state. Archived programs are included only when requested. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_programs \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_programs at https://app.chirply.io/api/mcp, same bearer token, same input.

The append-only promotion history — who was awarded which belt or stripe, when, by whom, and any grading notes. Newest first. Filter by member or program. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.list_promotions \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "offset": 0
  }'

Over MCP the same operation is the tool gym_list_promotions at https://app.chirply.io/api/mcp, same bearer token, same input.

One member's attendance shape — the drill-in panel on the attendance screen: check-ins per month over the last 12 months (quiet months included as zeros), their current consecutive-week training streak (a week counts with at least one visit; the current unfinished week doesn't break it), total visits in the last 90 days, and the date they were last seen. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.member_attendance_summary \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_member_attendance_summary at https://app.chirply.io/api/mcp, same bearer token, same input.

Award a member a new belt rank, or add a stripe to their current belt. Writes a PERMANENT promotion record to the member's history (visible on their belt card forever) and updates their enrollment. Promoting to a new belt resets stripes to 0. Asks for confirmation because promotion history is append-only — a mistaken award stays in the record. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.promote_member \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "enrollment_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "contact_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_promote_member at https://app.chirply.io/api/mcp, same bearer token, same input.

List active members who meet the next rank's minimums — enough classes attended since their last promotion AND enough months at their current rank, per the next rank's min_classes/min_months. Advisory only (the instructor always decides); members whose ladder has no higher rank are skipped. Scans up to `limit` active enrollments per call. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.promotion_eligibility \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "program_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "limit": 200
  }'

Over MCP the same operation is the tool gym_promotion_eligibility at https://app.chirply.io/api/mcp, same bearer token, same input.

Rewrite the order of a program's ENTIRE belt ladder in one action — the same whole-ladder reorder the Members & Belts screen's arrows perform. Pass every rank id in the program, lowest (day-one) belt first; each rank's sort_order is set to its position in the list. Members keep their current ranks — only the ladder's order changes, which changes what counts as each member's NEXT rank for promotion eligibility. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.reorder_belt_ranks \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "program_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "rank_ids": [
      "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
    ]
  }'

Over MCP the same operation is the tool gym_reorder_belt_ranks at https://app.chirply.io/api/mcp, same bearer token, same input.

Rotate the kiosk link: revoke every kiosk link ever issued and mint a fresh one — the 'lost or stolen tablet' action (the kiosk screen's 'Disconnect all tablets' button). EVERY tablet currently running the kiosk disconnects immediately and stays down until someone opens the new link on it, so check-ins stop until the tablets are re-set-up. Asks for confirmation for exactly that reason. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.rotate_kiosk_link \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool gym_rotate_kiosk_link at https://app.chirply.io/api/mcp, same bearer token, same input.

One-click starter timetable for an EMPTY schedule — the schedule screen's 'Load a sample week' button. Creates three programs (Brazilian Jiu-Jitsu, Striking, Kids Martial Arts — existing programs with those names are reused, not duplicated) and a realistic Mon–Sat starter timetable (ten recurring classes, one row per day they run) the gym edits into their own. Refuses if the gym already has ANY classes, so it can never double up or overwrite a real schedule. Creates only records inside this account — nothing outward-facing. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.seed_sample_schedule \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool gym_seed_sample_schedule at https://app.chirply.io/api/mcp, same bearer token, same input.

Update a belt rank's name, color, ladder position, or eligibility minimums. Omitted fields are left alone. Members already holding the rank keep it — only the rank's own definition changes. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.update_belt_rank \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_update_belt_rank at https://app.chirply.io/api/mcp, same bearer token, same input.

Update a scheduled class — move it to a different day or time, change its duration, instructor, location, capacity, or program, or toggle it off the live schedule with is_active. Omitted fields are left alone. Past check-ins are unaffected. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.update_class \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_update_class at https://app.chirply.io/api/mcp, same bearer token, same input.

Correct an enrollment: pause, resume or end a membership, or fix the recorded rank/stripes when they're wrong. This is the corrections path — it does NOT write a promotion record; award an earned rank with gym.promote_member so the member's history stays true. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.update_enrollment \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_update_enrollment at https://app.chirply.io/api/mcp, same bearer token, same input.

Update a program's name, description, color, sort order, or active state. Omitted fields are left alone. Setting is_active to true restores a previously archived program. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.update_program \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gym_update_program at https://app.chirply.io/api/mcp, same bearer token, same input.

Set or clear the welcome message shown at the top of the lobby check-in kiosk (for example 'Welcome to Apex Martial Arts — tap below to check in'). Takes effect the next time a kiosk screen refreshes; changes nothing else about the kiosk or its link. Requires the Martial Arts Gym app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gym.update_settings \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "kiosk_welcome": "example"
  }'

Over MCP the same operation is the tool gym_update_settings at https://app.chirply.io/api/mcp, same bearer token, same input.