# Soljio Docs > Guides for running a swim school on Soljio, signing up as a family, and building on the Soljio API. ## Docs - [Soljio documentation](https://docs.soljio.com/): Guides for running a swim school on Soljio, signing up for lessons as a family, and building on the Soljio API. - [Words Soljio uses](https://docs.soljio.com/glossary): What program, session, term, class date, student, household, guardian, report card, and instructor mean in Soljio. ## Developers - [Build on Soljio](https://docs.soljio.com/developers): Connect your swim school's own systems and AI agents to Soljio with the HTTP API, service tokens, and the MCP server. - [Quickstart](https://docs.soljio.com/developers/quickstart): Create a service token, read your school's programs with curl, and send your first write request in a few minutes. - [Authentication](https://docs.soljio.com/developers/authentication): How service tokens work: creating, sending, rotating, and revoking them, plus the status each one can have and what a failed check returns. - [Scopes](https://docs.soljio.com/developers/scopes): Every service-token and agent scope, what it allows, who may grant it, and how conditional scope rules change what a request needs. - [Requests and responses](https://docs.soljio.com/developers/requests-and-responses): Paths, required headers, body limits, the response envelope, success status codes, and value conventions for the Soljio HTTP API. - [Pagination](https://docs.soljio.com/developers/pagination): How to page through Soljio lists with cursors, the limits on page size, and the three pagination styles that different operations use. - [Idempotency](https://docs.soljio.com/developers/idempotency): How idempotency keys make Soljio commands safe to retry, what a replay returns, and which mistakes cause a 409 idempotency_conflict. - [Previews and approvals](https://docs.soljio.com/developers/previews-and-approvals): How schedule-changing commands work in two steps: preview a change, review what it would do, then apply it with an approval token. - [Async operations](https://docs.soljio.com/developers/async-operations): How to follow jobs started by invitations, custom domains, payment connections, and notification previews, and how reports are prepared. - [Errors](https://docs.soljio.com/developers/errors): The error body, every error code the Soljio API returns with its status and cause, the headers that help, and how to respond to each. - [Rate limits](https://docs.soljio.com/developers/rate-limits): The per-token and per-school request budgets, the RateLimit headers on every response, and how to back off and retry after a 429. - [Agents and MCP](https://docs.soljio.com/developers/agents-and-mcp): Connect AI agents to Soljio through the MCP server: how agents sign in, which tools, views, and events exist, and how tool approval and read-only hints work. - [Connect an agent](https://docs.soljio.com/developers/connect-an-agent): What a school owner or admin sees when approving an AI agent, from entering a device code to choosing access, plus how to disconnect it later. - [OpenAPI contract](https://docs.soljio.com/developers/openapi): Where to fetch Soljio's OpenAPI contract, how API v0 relates to OpenAPI 3.1.2, and how to use the contract for clients and tool definitions. ## API reference - [Soljio Organization API](https://docs.soljio.com/api): Organization-scoped domain reads, commands and tracked jobs. See docs/api/coverage.json for source mappings and explicit exceptions. Family self-service and… ### organizations - [List organizations](https://docs.soljio.com/api/organizations/list-organizations): Organization-scoped organization read. Requires organization.read. Unknown or… Reference for the GET /organizations endpoint in the Soljio Organization API. - [Check List organizations](https://docs.soljio.com/api/organizations/head-list-organizations): Organization-scoped organization read. Requires organization.read. Unknown or… Reference for the HEAD /organizations endpoint in the Soljio Organization API. - [Get organization](https://docs.soljio.com/api/organizations/get-organization): Organization-scoped organization read. Requires organization.read. Unknown… Reference for the GET /organizations/{id} endpoint in the Soljio Organization API. - [Check Get organization](https://docs.soljio.com/api/organizations/head-get-organization): Organization-scoped organization read. Requires organization.read.… Reference for the HEAD /organizations/{id} endpoint in the Soljio Organization API. ### locations - [List locations](https://docs.soljio.com/api/locations/list-locations): Organization-scoped location read. Requires locations.read. Unknown or repeated… Reference for the GET /locations endpoint in the Soljio Organization API. - [Check List locations](https://docs.soljio.com/api/locations/head-list-locations): Organization-scoped location read. Requires locations.read. Unknown or repeated… Reference for the HEAD /locations endpoint in the Soljio Organization API. - [Get location](https://docs.soljio.com/api/locations/get-location): Organization-scoped location read. Requires locations.read. Unknown or… Reference for the GET /locations/{id} endpoint in the Soljio Organization API. - [Check Get location](https://docs.soljio.com/api/locations/head-get-location): Organization-scoped location read. Requires locations.read. Unknown or… Reference for the HEAD /locations/{id} endpoint in the Soljio Organization API. ### programs - [List programs](https://docs.soljio.com/api/programs/list-programs): Organization-scoped program read. Requires catalog.read. Unknown or repeated query… Reference for the GET /programs endpoint in the Soljio Organization API. - [Check List programs](https://docs.soljio.com/api/programs/head-list-programs): Organization-scoped program read. Requires catalog.read. Unknown or repeated query… Reference for the HEAD /programs endpoint in the Soljio Organization API. - [Get program](https://docs.soljio.com/api/programs/get-program): Organization-scoped program read. Requires catalog.read. Unknown or repeated… Reference for the GET /programs/{id} endpoint in the Soljio Organization API. - [Check Get program](https://docs.soljio.com/api/programs/head-get-program): Organization-scoped program read. Requires catalog.read. Unknown or repeated… Reference for the HEAD /programs/{id} endpoint in the Soljio Organization API. ### offerings - [List offerings](https://docs.soljio.com/api/offerings/list-offerings): Organization-scoped offering read. Requires catalog.read. Unknown or repeated query… Reference for the GET /offerings endpoint in the Soljio Organization API. - [Check List offerings](https://docs.soljio.com/api/offerings/head-list-offerings): Organization-scoped offering read. Requires catalog.read. Unknown or repeated… Reference for the HEAD /offerings endpoint in the Soljio Organization API. - [Get offering](https://docs.soljio.com/api/offerings/get-offering): Organization-scoped offering read. Requires catalog.read. Unknown or repeated… Reference for the GET /offerings/{id} endpoint in the Soljio Organization API. - [Check Get offering](https://docs.soljio.com/api/offerings/head-get-offering): Organization-scoped offering read. Requires catalog.read. Unknown or repeated… Reference for the HEAD /offerings/{id} endpoint in the Soljio Organization API. ### sessions - [List sessions](https://docs.soljio.com/api/sessions/list-sessions): Organization-scoped session read. Requires schedule.read. Unknown or repeated query… Reference for the GET /sessions endpoint in the Soljio Organization API. - [Check List sessions](https://docs.soljio.com/api/sessions/head-list-sessions): Organization-scoped session read. Requires schedule.read. Unknown or repeated query… Reference for the HEAD /sessions endpoint in the Soljio Organization API. - [Get session](https://docs.soljio.com/api/sessions/get-session): Organization-scoped session read. Requires schedule.read. Unknown or repeated… Reference for the GET /sessions/{id} endpoint in the Soljio Organization API. - [Check Get session](https://docs.soljio.com/api/sessions/head-get-session): Organization-scoped session read. Requires schedule.read. Unknown or repeated… Reference for the HEAD /sessions/{id} endpoint in the Soljio Organization API. - [Preview additional offering dates](https://docs.soljio.com/api/sessions/preview-offering-schedule): Creates a durable preview expiring after 15 minutes.… Reference for the POST /commands/preview_offering_schedule endpoint in the Soljio Organization API. - [Apply a reviewed schedule preview](https://docs.soljio.com/api/sessions/apply-offering-schedule): Requires the unexpired preview and approval token from the… Reference for the POST /commands/apply_offering_schedule endpoint in the Soljio Organization API. ### participants - [List participants](https://docs.soljio.com/api/participants/list-participants): Organization-scoped participant read. Requires participants.read. Unknown or… Reference for the GET /participants endpoint in the Soljio Organization API. - [Check List participants](https://docs.soljio.com/api/participants/head-list-participants): Organization-scoped participant read. Requires participants.read. Unknown or… Reference for the HEAD /participants endpoint in the Soljio Organization API. - [Get participant](https://docs.soljio.com/api/participants/get-participant): Organization-scoped participant read. Requires participants.read. Unknown… Reference for the GET /participants/{id} endpoint in the Soljio Organization API. - [Check Get participant](https://docs.soljio.com/api/participants/head-get-participant): Organization-scoped participant read. Requires participants.read. Unknown… Reference for the HEAD /participants/{id} endpoint in the Soljio Organization API. ### enrollments - [List enrollments](https://docs.soljio.com/api/enrollments/list-enrollments): Organization-scoped enrollment read. Requires enrollments.read. Unknown or… Reference for the GET /enrollments endpoint in the Soljio Organization API. - [Check List enrollments](https://docs.soljio.com/api/enrollments/head-list-enrollments): Organization-scoped enrollment read. Requires enrollments.read. Unknown or… Reference for the HEAD /enrollments endpoint in the Soljio Organization API. - [Get enrollment](https://docs.soljio.com/api/enrollments/get-enrollment): Organization-scoped enrollment read. Requires enrollments.read. Unknown or… Reference for the GET /enrollments/{id} endpoint in the Soljio Organization API. - [Check Get enrollment](https://docs.soljio.com/api/enrollments/head-get-enrollment): Organization-scoped enrollment read. Requires enrollments.read. Unknown or… Reference for the HEAD /enrollments/{id} endpoint in the Soljio Organization API. - [Create an enrollment](https://docs.soljio.com/api/enrollments/create-enrollment): Uses staff enrollment rules for capacity, waitlist, duplicates… Reference for the POST /commands/create_enrollment endpoint in the Soljio Organization API. - [Cancel an enrollment](https://docs.soljio.com/api/enrollments/cancel-enrollment): May automatically promote a waitlisted participant and send… Reference for the POST /commands/cancel_enrollment endpoint in the Soljio Organization API. ### organization-commands - [Add a signed credit or charge with a reason to an open invoice.](https://docs.soljio.com/api/organization-commands/add-invoice-adjustment): Add a signed credit or charge with a reason to an open… Reference for the POST /commands/add_invoice_adjustment endpoint in the Soljio Organization API. - [Add a holiday to a term after reviewing a preview; class dates in the term on that day are cancelled and their families notified.](https://docs.soljio.com/api/organization-commands/add-term-holiday): Add a holiday to a term after reviewing a preview; class dates in… Reference for the POST /commands/add_term_holiday endpoint in the Soljio Organization API. - [Preview: Add a holiday to a term after reviewing a preview; class dates in the term on that day are cancelled and their families notified.](https://docs.soljio.com/api/organization-commands/preview-add-term-holiday): Validate the entire command without committing its domain… Reference for the POST /commands/preview_add_term_holiday endpoint in the Soljio Organization API. - [Accept a family's requested lesson change, moving the lessons if the times are still open, or decline it.](https://docs.soljio.com/api/organization-commands/answer-private-lesson-change): Accept a family's requested lesson change, moving the… Reference for the POST /commands/answer_private_lesson_change endpoint in the Soljio Organization API. - [Apply a validated batch of parsed CSV rows; inspect returned row issues and batch status.](https://docs.soljio.com/api/organization-commands/apply-import): Apply a validated batch of parsed CSV rows; inspect returned row… Reference for the POST /commands/apply_import endpoint in the Soljio Organization API. - [Approve or decline a private lesson request waiting on the school.](https://docs.soljio.com/api/organization-commands/approve-private-lesson-booking): Approve or decline a private lesson request waiting… Reference for the POST /commands/approve_private_lesson_booking endpoint in the Soljio Organization API. - [Archive an offering.](https://docs.soljio.com/api/organization-commands/archive-offering): Archive an offering. Requires catalog.publish. All writes require… Reference for the POST /commands/archive_offering endpoint in the Soljio Organization API. - [Archive a program after its current offerings are archived.](https://docs.soljio.com/api/organization-commands/archive-program): Archive a program after its current offerings are archived.… Reference for the POST /commands/archive_program endpoint in the Soljio Organization API. - [Assign or unassign organization work to an active staff member.](https://docs.soljio.com/api/organization-commands/assign-action): Assign or unassign organization work to an active staff member.… Reference for the POST /commands/assign_action endpoint in the Soljio Organization API. - [Assign or unassign a conversation to an active organization staff member.](https://docs.soljio.com/api/organization-commands/assign-conversation): Assign or unassign a conversation to an active organization… Reference for the POST /commands/assign_conversation endpoint in the Soljio Organization API. - [Cancel a private lesson booking, one lesson, or a lesson and the ones after it after reviewing a preview; returns credits and notifies the family.](https://docs.soljio.com/api/organization-commands/cancel-private-lesson-booking): Cancel a private lesson booking, one lesson, or a… Reference for the POST /commands/cancel_private_lesson_booking endpoint in the Soljio Organization API. - [Preview: Cancel a private lesson booking, one lesson, or a lesson and the ones after it after reviewing a preview; returns credits and notifies the family.](https://docs.soljio.com/api/organization-commands/preview-cancel-private-lesson-booking): Validate the entire command without… Reference for the POST /commands/preview_cancel_private_lesson_booking endpoint in the Soljio Organization API. - [Cancel a class date and release its resources.](https://docs.soljio.com/api/organization-commands/cancel-session): Cancel a class date and release its resources. Requires… Reference for the POST /commands/cancel_session endpoint in the Soljio Organization API. - [Preview: Cancel a class date and release its resources.](https://docs.soljio.com/api/organization-commands/preview-cancel-session): Validate the entire command without committing its domain… Reference for the POST /commands/preview_cancel_session endpoint in the Soljio Organization API. - [Change which of the family's students attend upcoming lessons at the price difference quote_private_lesson_roster_change returned.](https://docs.soljio.com/api/organization-commands/change-private-lesson-roster): Change which of the family's students attend upcoming… Reference for the POST /commands/change_private_lesson_roster endpoint in the Soljio Organization API. - [Use a makeup credit only when a confirmed destination seat can be created in the same write.](https://docs.soljio.com/api/organization-commands/consume-makeup-credit): Use a makeup credit only when a confirmed destination seat… Reference for the POST /commands/consume_makeup_credit endpoint in the Soljio Organization API. - [Go ahead with a booking waiting on guests without some of them, at the amount quote_private_lesson_without_guests returned.](https://docs.soljio.com/api/organization-commands/continue-private-lesson-without-guests): Go ahead with a booking waiting on guests… Reference for the POST /commands/continue_private_lesson_without_guests endpoint in the Soljio Organization API. - [Add an active instructor by name. Link the school account they teach as with update_instructor.](https://docs.soljio.com/api/organization-commands/create-instructor): Add an active instructor by name. Link the school account they… Reference for the POST /commands/create_instructor endpoint in the Soljio Organization API. - [Add a registration question to a program.](https://docs.soljio.com/api/organization-commands/create-intake-question): Add a registration question to a program. Requires… Reference for the POST /commands/create_intake_question endpoint in the Soljio Organization API. - [Create an invoice from eligible enrollment balances.](https://docs.soljio.com/api/organization-commands/create-invoice): Create an invoice from eligible enrollment balances. Requires… Reference for the POST /commands/create_invoice endpoint in the Soljio Organization API. - [Create an offering with validated commercial terms and optional initial schedule.](https://docs.soljio.com/api/organization-commands/create-offering): Create an offering with validated commercial terms and optional… Reference for the POST /commands/create_offering endpoint in the Soljio Organization API. - [Preview: Create an offering with validated commercial terms and optional initial schedule.](https://docs.soljio.com/api/organization-commands/preview-create-offering): Validate the entire command without committing its domain… Reference for the POST /commands/preview_create_offering endpoint in the Soljio Organization API. - [Create a participant and optional household; queue new household access invitations.](https://docs.soljio.com/api/organization-commands/create-participant): Create a participant and optional household; queue new household… Reference for the POST /commands/create_participant endpoint in the Soljio Organization API. - [Book private lessons for a family at the totals quote_private_lesson returned, after reviewing a preview; invites guests and notifies the family.](https://docs.soljio.com/api/organization-commands/create-private-lesson-booking): Book private lessons for a family at the totals… Reference for the POST /commands/create_private_lesson_booking endpoint in the Soljio Organization API. - [Preview: Book private lessons for a family at the totals quote_private_lesson returned, after reviewing a preview; invites guests and notifies the family.](https://docs.soljio.com/api/organization-commands/preview-create-private-lesson-booking): Validate the entire command without… Reference for the POST /commands/preview_create_private_lesson_booking endpoint in the Soljio Organization API. - [Create a program.](https://docs.soljio.com/api/organization-commands/create-program): Create a program. Requires catalog.write. All writes require… Reference for the POST /commands/create_program endpoint in the Soljio Organization API. - [Create a promo code.](https://docs.soljio.com/api/organization-commands/create-promo-code): Create a promo code. Requires settings.write. All writes require… Reference for the POST /commands/create_promo_code endpoint in the Soljio Organization API. - [Create a scheduled class date.](https://docs.soljio.com/api/organization-commands/create-session): Create a scheduled class date. Requires schedule.apply. All writes… Reference for the POST /commands/create_session endpoint in the Soljio Organization API. - [Preview: Create a scheduled class date.](https://docs.soljio.com/api/organization-commands/preview-create-session): Validate the entire command without committing its domain… Reference for the POST /commands/preview_create_session endpoint in the Soljio Organization API. - [Create a term: a named season with a start date and optional end date.](https://docs.soljio.com/api/organization-commands/create-term): Create a term: a named season with a start date and optional end date.… Reference for the POST /commands/create_term endpoint in the Soljio Organization API. - [Remove a custom domain from hosting and disable tenant routing.](https://docs.soljio.com/api/organization-commands/disable-custom-domain): Remove a custom domain from hosting and disable tenant… Reference for the POST /commands/disable_custom_domain endpoint in the Soljio Organization API. - [Close the connected Stripe account and disable online payments.](https://docs.soljio.com/api/organization-commands/disconnect-payment-connection): Close the connected Stripe account and disable online… Reference for the POST /commands/disconnect_payment_connection endpoint in the Soljio Organization API. - [Validate a batch of parsed CSV rows without applying changes.](https://docs.soljio.com/api/organization-commands/dry-run-import): Validate a batch of parsed CSV rows without applying changes.… Reference for the POST /commands/dry_run_import endpoint in the Soljio Organization API. - [Create a staff invitation and queue its email. The acceptance credential is never returned.](https://docs.soljio.com/api/organization-commands/invite-staff): Create a staff invitation and queue its email. The acceptance… Reference for the POST /commands/invite_staff endpoint in the Soljio Organization API. - [Issue a makeup credit using the same eligibility rules as staff operations.](https://docs.soljio.com/api/organization-commands/issue-makeup-credit): Issue a makeup credit using the same eligibility rules as staff… Reference for the POST /commands/issue_makeup_credit endpoint in the Soljio Organization API. - [Mark every unmarked student on a class date present.](https://docs.soljio.com/api/organization-commands/mark-all-present): Mark every unmarked student on a class date present. Requires… Reference for the POST /commands/mark_all_present endpoint in the Soljio Organization API. - [Record attendance for an enrollment or makeup participant.](https://docs.soljio.com/api/organization-commands/mark-attendance): Record attendance for an enrollment or makeup participant. Requires… Reference for the POST /commands/mark_attendance endpoint in the Soljio Organization API. - [Move a program registration question up or down.](https://docs.soljio.com/api/organization-commands/move-intake-question): Move a program registration question up or down. Requires… Reference for the POST /commands/move_intake_question endpoint in the Soljio Organization API. - [Move upcoming confirmed lessons of a booking to new times or instructors after reviewing a preview; notifies the family.](https://docs.soljio.com/api/organization-commands/move-private-lessons): Move upcoming confirmed lessons of a booking to new times or… Reference for the POST /commands/move_private_lessons endpoint in the Soljio Organization API. - [Preview: Move upcoming confirmed lessons of a booking to new times or instructors after reviewing a preview; notifies the family.](https://docs.soljio.com/api/organization-commands/preview-move-private-lessons): Validate the entire command without committing its… Reference for the POST /commands/preview_move_private_lessons endpoint in the Soljio Organization API. - [Render the current notification template with sample content; poll get_job for the message.](https://docs.soljio.com/api/organization-commands/preview-notification-template): Render the current notification template with sample… Reference for the POST /commands/preview_notification_template endpoint in the Soljio Organization API. - [Promote the next eligible waitlisted enrollment when capacity permits.](https://docs.soljio.com/api/organization-commands/promote-waitlist): Promote the next eligible waitlisted enrollment when capacity… Reference for the POST /commands/promote_waitlist endpoint in the Soljio Organization API. - [Publish an organization notification template.](https://docs.soljio.com/api/organization-commands/publish-notification-template): Publish an organization notification template.… Reference for the POST /commands/publish_notification_template endpoint in the Soljio Organization API. - [Record review of a payment provider state discrepancy.](https://docs.soljio.com/api/organization-commands/reconcile-provider-state): Record review of a payment provider state discrepancy.… Reference for the POST /commands/reconcile_provider_state endpoint in the Soljio Organization API. - [Record evidence of recipient notification consent.](https://docs.soljio.com/api/organization-commands/record-notification-consent): Record evidence of recipient notification consent.… Reference for the POST /commands/record_notification_consent endpoint in the Soljio Organization API. - [Record a payment collected outside the payment provider. Available on the Pro and Scale plans.](https://docs.soljio.com/api/organization-commands/record-offline-payment): Record a payment collected outside the payment provider.… Reference for the POST /commands/record_offline_payment endpoint in the Soljio Organization API. - [Record an offline refund without exceeding the refundable balance.](https://docs.soljio.com/api/organization-commands/record-offline-refund): Record an offline refund without exceeding the refundable… Reference for the POST /commands/record_offline_refund endpoint in the Soljio Organization API. - [Record a student's attendance at a private lesson.](https://docs.soljio.com/api/organization-commands/record-private-lesson-attendance): Record a student's attendance at a private lesson.… Reference for the POST /commands/record_private_lesson_attendance endpoint in the Soljio Organization API. - [Record an offline refund for a lesson pack and remove unused credits.](https://docs.soljio.com/api/organization-commands/record-private-lesson-pack-refund): Record an offline refund for a lesson pack and… Reference for the POST /commands/record_private_lesson_pack_refund endpoint in the Soljio Organization API. - [Record a lesson pack sold to a family and paid outside the payment provider. Paid packs require the Pro or Scale plan.](https://docs.soljio.com/api/organization-commands/record-private-lesson-pack-sale): Record a lesson pack sold to a family and paid… Reference for the POST /commands/record_private_lesson_pack_sale endpoint in the Soljio Organization API. - [Record a private lesson booking payment collected outside the payment provider. Available on the Pro and Scale plans.](https://docs.soljio.com/api/organization-commands/record-private-lesson-payment): Record a private lesson booking payment collected… Reference for the POST /commands/record_private_lesson_payment endpoint in the Soljio Organization API. - [Record an offline refund of money owed back on a private lesson booking.](https://docs.soljio.com/api/organization-commands/record-private-lesson-refund): Record an offline refund of money owed back on a… Reference for the POST /commands/record_private_lesson_refund endpoint in the Soljio Organization API. - [Check custom domain verification and routing.](https://docs.soljio.com/api/organization-commands/refresh-custom-domain): Check custom domain verification and routing. Requires… Reference for the POST /commands/refresh_custom_domain endpoint in the Soljio Organization API. - [Remove a holiday from a term. Class dates already cancelled for it stay cancelled.](https://docs.soljio.com/api/organization-commands/remove-term-holiday): Remove a holiday from a term. Class dates already cancelled for… Reference for the POST /commands/remove_term_holiday endpoint in the Soljio Organization API. - [Replace the future schedule with reviewed dates and recurring rules.](https://docs.soljio.com/api/organization-commands/replace-offering-schedule): Replace the future schedule with reviewed dates and… Reference for the POST /commands/replace_offering_schedule endpoint in the Soljio Organization API. - [Preview: Replace the future schedule with reviewed dates and recurring rules.](https://docs.soljio.com/api/organization-commands/preview-replace-offering-schedule): Validate the entire command without committing… Reference for the POST /commands/preview_replace_offering_schedule endpoint in the Soljio Organization API. - [Request a custom domain; poll get_job and list_custom_domains for DNS verification.](https://docs.soljio.com/api/organization-commands/request-custom-domain): Request a custom domain; poll get_job and list_custom_domains… Reference for the POST /commands/request_custom_domain endpoint in the Soljio Organization API. - [Queue a refund of money owed on a private lesson booking to the cards it was paid with; payment reconciliation issues it.](https://docs.soljio.com/api/organization-commands/request-private-lesson-card-refund): Queue a refund of money owed on a private lesson… Reference for the POST /commands/request_private_lesson_card_refund endpoint in the Soljio Organization API. - [Queue a card refund for a lesson pack bought online and remove unused credits; payment reconciliation issues it.](https://docs.soljio.com/api/organization-commands/request-private-lesson-pack-card-refund): Queue a card refund for a lesson pack… Reference for the POST /commands/request_private_lesson_pack_card_refund endpoint in the Soljio Organization API. - [Start a report job; poll get_report, then paginate get_report_rows.](https://docs.soljio.com/api/organization-commands/request-report): Start a report job; poll get_report, then paginate get_report_rows.… Reference for the POST /commands/request_report endpoint in the Soljio Organization API. - [Replace an invitation and queue its email.](https://docs.soljio.com/api/organization-commands/resend-staff-invitation): Replace an invitation and queue its email. Requires… Reference for the POST /commands/resend_staff_invitation endpoint in the Soljio Organization API. - [Reset a notification template to its system default.](https://docs.soljio.com/api/organization-commands/reset-notification-template): Reset a notification template to its system default.… Reference for the POST /commands/reset_notification_template endpoint in the Soljio Organization API. - [Remove a recipient block after explicit confirmation; consent and preferences still apply.](https://docs.soljio.com/api/organization-commands/revoke-notification-suppression): Remove a recipient block after explicit… Reference for the POST /commands/revoke_notification_suppression endpoint in the Soljio Organization API. - [Revoke a pending staff invitation.](https://docs.soljio.com/api/organization-commands/revoke-staff-invitation): Revoke a pending staff invitation. Requires staff.invite.… Reference for the POST /commands/revoke_staff_invitation endpoint in the Soljio Organization API. - [Set weekly private lesson hours and date exceptions for a location, instructor or resource.](https://docs.soljio.com/api/organization-commands/save-private-lesson-availability): Set weekly private lesson hours and date… Reference for the POST /commands/save_private_lesson_availability endpoint in the Soljio Organization API. - [Create or update a lesson pack families can buy.](https://docs.soljio.com/api/organization-commands/save-private-lesson-pack-type): Create or update a lesson pack families can buy.… Reference for the POST /commands/save_private_lesson_pack_type endpoint in the Soljio Organization API. - [Create or update a private lesson type with its pricing, rules, locations and instructors.](https://docs.soljio.com/api/organization-commands/save-private-lesson-type): Create or update a private lesson type with its pricing,… Reference for the POST /commands/save_private_lesson_type endpoint in the Soljio Organization API. - [Queue a household account invitation using recipient eligibility and resend limits.](https://docs.soljio.com/api/organization-commands/send-household-claim): Queue a household account invitation using recipient… Reference for the POST /commands/send_household_claim endpoint in the Soljio Organization API. - [Activate or archive an instructor.](https://docs.soljio.com/api/organization-commands/set-instructor-status): Activate or archive an instructor. Requires… Reference for the POST /commands/set_instructor_status endpoint in the Soljio Organization API. - [Archive or restore a program registration question.](https://docs.soljio.com/api/organization-commands/set-intake-question-archived): Archive or restore a program registration question.… Reference for the POST /commands/set_intake_question_archived endpoint in the Soljio Organization API. - [Set an organization notification preference.](https://docs.soljio.com/api/organization-commands/set-notification-preference): Set an organization notification preference. Requires… Reference for the POST /commands/set_notification_preference endpoint in the Soljio Organization API. - [Update recipient notification suppression.](https://docs.soljio.com/api/organization-commands/set-notification-suppression): Update recipient notification suppression. Requires… Reference for the POST /commands/set_notification_suppression endpoint in the Soljio Organization API. - [Replace the instructors assigned to an offering.](https://docs.soljio.com/api/organization-commands/set-offering-instructors): Replace the instructors assigned to an offering. Requires… Reference for the POST /commands/set_offering_instructors endpoint in the Soljio Organization API. - [Activate or deactivate a promo code.](https://docs.soljio.com/api/organization-commands/set-promo-code-active): Activate or deactivate a promo code. Requires settings.write.… Reference for the POST /commands/set_promo_code_active endpoint in the Soljio Organization API. - [Mark one skill on a student's checklist as attempted or completed, or clear it. Families see marks on their report card.](https://docs.soljio.com/api/organization-commands/set-skill-mark): Mark one skill on a student's checklist as attempted or completed,… Reference for the POST /commands/set_skill_mark endpoint in the Soljio Organization API. - [Snooze organization work for up to 30 days, or clear its snooze.](https://docs.soljio.com/api/organization-commands/snooze-action): Snooze organization work for up to 30 days, or clear its snooze.… Reference for the POST /commands/snooze_action endpoint in the Soljio Organization API. - [Suppress email delivery to an organization recipient.](https://docs.soljio.com/api/organization-commands/suppress-email-recipient): Suppress email delivery to an organization recipient.… Reference for the POST /commands/suppress_email_recipient endpoint in the Soljio Organization API. - [Refresh the connected Stripe account capabilities.](https://docs.soljio.com/api/organization-commands/sync-payment-connection): Refresh the connected Stripe account capabilities. Requires… Reference for the POST /commands/sync_payment_connection endpoint in the Soljio Organization API. - [Transfer an enrollment to another offering or class date.](https://docs.soljio.com/api/organization-commands/transfer-enrollment): Transfer an enrollment to another offering or class date.… Reference for the POST /commands/transfer_enrollment endpoint in the Soljio Organization API. - [Update the sender name, reply-to address and postal address on school email.](https://docs.soljio.com/api/organization-commands/update-email-identity): Update the sender name, reply-to address and postal address… Reference for the POST /commands/update_email_identity endpoint in the Soljio Organization API. - [Update an instructor's name, slug or linked school account.](https://docs.soljio.com/api/organization-commands/update-instructor): Update an instructor's name, slug or linked school account.… Reference for the POST /commands/update_instructor endpoint in the Soljio Organization API. - [Update a program registration question.](https://docs.soljio.com/api/organization-commands/update-intake-question): Update a program registration question. Requires… Reference for the POST /commands/update_intake_question endpoint in the Soljio Organization API. - [Update an offering's details, location, capacity, commercial terms or status after reviewing a preview.](https://docs.soljio.com/api/organization-commands/update-offering): Update an offering's details, location, capacity, commercial terms… Reference for the POST /commands/update_offering endpoint in the Soljio Organization API. - [Preview: Update an offering's details, location, capacity, commercial terms or status after reviewing a preview.](https://docs.soljio.com/api/organization-commands/preview-update-offering): Validate the entire command without committing its domain… Reference for the POST /commands/preview_update_offering endpoint in the Soljio Organization API. - [Update organization profile and slug.](https://docs.soljio.com/api/organization-commands/update-organization-profile): Update organization profile and slug. Requires… Reference for the POST /commands/update_organization_profile endpoint in the Soljio Organization API. - [Update organization profile, timezone and operating defaults.](https://docs.soljio.com/api/organization-commands/update-organization-settings): Update organization profile, timezone and operating… Reference for the POST /commands/update_organization_settings endpoint in the Soljio Organization API. - [Update a participant profile, household association and provider consent.](https://docs.soljio.com/api/organization-commands/update-participant): Update a participant profile, household association and provider… Reference for the POST /commands/update_participant endpoint in the Soljio Organization API. - [Update a student's safety details such as swim ability, medical notes and emergency contacts.](https://docs.soljio.com/api/organization-commands/update-participant-safety): Update a student's safety details such as swim ability,… Reference for the POST /commands/update_participant_safety endpoint in the Soljio Organization API. - [Update program details or status.](https://docs.soljio.com/api/organization-commands/update-program): Update program details or status. Requires catalog.write. All writes… Reference for the POST /commands/update_program endpoint in the Soljio Organization API. - [Update a recurring rule and reconcile future class dates.](https://docs.soljio.com/api/organization-commands/update-recurring-schedule-rule): Update a recurring rule and reconcile future class… Reference for the POST /commands/update_recurring_schedule_rule endpoint in the Soljio Organization API. - [Preview: Update a recurring rule and reconcile future class dates.](https://docs.soljio.com/api/organization-commands/preview-update-recurring-schedule-rule): Validate the entire command without… Reference for the POST /commands/preview_update_recurring_schedule_rule endpoint in the Soljio Organization API. - [Change a class date and its resource assignments.](https://docs.soljio.com/api/organization-commands/update-session): Change a class date and its resource assignments. Requires… Reference for the POST /commands/update_session endpoint in the Soljio Organization API. - [Preview: Change a class date and its resource assignments.](https://docs.soljio.com/api/organization-commands/preview-update-session): Validate the entire command without committing its domain… Reference for the POST /commands/preview_update_session endpoint in the Soljio Organization API. - [Set or clear the sibling discount.](https://docs.soljio.com/api/organization-commands/update-sibling-discount): Set or clear the sibling discount. Requires settings.write.… Reference for the POST /commands/update_sibling_discount endpoint in the Soljio Organization API. - [Change a non-owner staff membership role. Owner access requires a human owner.](https://docs.soljio.com/api/organization-commands/update-staff-role): Change a non-owner staff membership role. Owner access requires a… Reference for the POST /commands/update_staff_role endpoint in the Soljio Organization API. - [Activate or remove a non-owner membership. Organization credentials survive creator removal.](https://docs.soljio.com/api/organization-commands/update-staff-status): Activate or remove a non-owner membership. Organization… Reference for the POST /commands/update_staff_status endpoint in the Soljio Organization API. - [Replace the school's swim ability levels.](https://docs.soljio.com/api/organization-commands/update-swim-ability-levels): Replace the school's swim ability levels. Requires… Reference for the POST /commands/update_swim_ability_levels endpoint in the Soljio Organization API. - [Update a term's name, dates or status.](https://docs.soljio.com/api/organization-commands/update-term): Update a term's name, dates or status. Requires catalog.write. All… Reference for the POST /commands/update_term endpoint in the Soljio Organization API. - [Create or update a location.](https://docs.soljio.com/api/organization-commands/upsert-location): Create or update a location. Requires locations.write. All writes… Reference for the POST /commands/upsert_location endpoint in the Soljio Organization API. - [Create or update an organization report-card template.](https://docs.soljio.com/api/organization-commands/upsert-report-card-template): Create or update an organization report-card template.… Reference for the POST /commands/upsert_report_card_template endpoint in the Soljio Organization API. - [Create or update an organization resource.](https://docs.soljio.com/api/organization-commands/upsert-resource): Create or update an organization resource. Requires… Reference for the POST /commands/upsert_resource endpoint in the Soljio Organization API. - [Void an unpaid invoice.](https://docs.soljio.com/api/organization-commands/void-invoice): Void an unpaid invoice. Requires invoices.write. All writes require… Reference for the POST /commands/void_invoice endpoint in the Soljio Organization API. - [Void an incorrectly recorded offline payment.](https://docs.soljio.com/api/organization-commands/void-offline-payment): Void an incorrectly recorded offline payment. Requires… Reference for the POST /commands/void_offline_payment endpoint in the Soljio Organization API. ### organization-reads - [Get asynchronous operation status and result; also requires the operation’s original scope.](https://docs.soljio.com/api/organization-reads/get-job-resource): Get asynchronous operation status and result; also requires the operation’s… Reference for the GET /jobs/{id} endpoint in the Soljio Organization API. - [Check Get asynchronous operation status and result; also requires the operation’s original scope.](https://docs.soljio.com/api/organization-reads/head-get-job-resource): Get asynchronous operation status and result; also requires the operation’s… Reference for the HEAD /jobs/{id} endpoint in the Soljio Organization API. - [Export data.](https://docs.soljio.com/api/organization-reads/export-data): Export data. An organization-scoped read using JSON filter arguments;… Reference for the POST /queries/export_data endpoint in the Soljio Organization API. - [Get catalog overview.](https://docs.soljio.com/api/organization-reads/get-catalog-overview): Get catalog overview. An organization-scoped read using JSON… Reference for the POST /queries/get_catalog_overview endpoint in the Soljio Organization API. - [Get class date details.](https://docs.soljio.com/api/organization-reads/get-class-date-details): Get class date details. An organization-scoped read using… Reference for the POST /queries/get_class_date_details endpoint in the Soljio Organization API. - [Get conversation.](https://docs.soljio.com/api/organization-reads/get-conversation): Get conversation. An organization-scoped read using JSON filter… Reference for the POST /queries/get_conversation endpoint in the Soljio Organization API. - [Get the published waiver version families currently accept.](https://docs.soljio.com/api/organization-reads/get-current-waiver-version): Get the published waiver version families currently… Reference for the POST /queries/get_current_waiver_version endpoint in the Soljio Organization API. - [Get the sibling discount and promo codes.](https://docs.soljio.com/api/organization-reads/get-discount-settings): Get the sibling discount and promo codes. An… Reference for the POST /queries/get_discount_settings endpoint in the Soljio Organization API. - [Get the registration answers families gave for up to 250 enrollments at a time.](https://docs.soljio.com/api/organization-reads/get-enrollment-intake-answers): Get the registration answers families gave for up to… Reference for the POST /queries/get_enrollment_intake_answers endpoint in the Soljio Organization API. - [Get supported CSV column keys, required columns and sample rows for each import kind.](https://docs.soljio.com/api/organization-reads/get-import-templates): Get supported CSV column keys, required columns and sample rows… Reference for the POST /queries/get_import_templates endpoint in the Soljio Organization API. - [Get an invoice with its line items, discounts and adjustments.](https://docs.soljio.com/api/organization-reads/get-invoice): Get an invoice with its line items, discounts and adjustments. An… Reference for the POST /queries/get_invoice endpoint in the Soljio Organization API. - [Get invoice workspace.](https://docs.soljio.com/api/organization-reads/get-invoice-workspace): Get invoice workspace. An organization-scoped read using JSON… Reference for the POST /queries/get_invoice_workspace endpoint in the Soljio Organization API. - [Get asynchronous operation status and result; also requires the operation’s original scope.](https://docs.soljio.com/api/organization-reads/get-job): Get asynchronous operation status and result; also requires the operation’s… Reference for the POST /queries/get_job endpoint in the Soljio Organization API. - [Get next class date.](https://docs.soljio.com/api/organization-reads/get-next-class-date): Get next class date. An organization-scoped read using JSON… Reference for the POST /queries/get_next_class_date endpoint in the Soljio Organization API. - [Get a message delivery attempt and its bounded transition history.](https://docs.soljio.com/api/organization-reads/get-notification-delivery): Get a message delivery attempt and its bounded transition… Reference for the POST /queries/get_notification_delivery endpoint in the Soljio Organization API. - [Get notification template.](https://docs.soljio.com/api/organization-reads/get-notification-template): Get notification template. An organization-scoped read… Reference for the POST /queries/get_notification_template endpoint in the Soljio Organization API. - [Get offering defaults.](https://docs.soljio.com/api/organization-reads/get-offering-defaults): Get offering defaults. An organization-scoped read using JSON… Reference for the POST /queries/get_offering_defaults endpoint in the Soljio Organization API. - [Get offering details.](https://docs.soljio.com/api/organization-reads/get-offering-details): Get offering details. An organization-scoped read using JSON… Reference for the POST /queries/get_offering_details endpoint in the Soljio Organization API. - [Get offering schedule.](https://docs.soljio.com/api/organization-reads/get-offering-schedule): Get offering schedule. An organization-scoped read using JSON… Reference for the POST /queries/get_offering_schedule endpoint in the Soljio Organization API. - [Get organization work queues; personal dismissals are not available to service actors.](https://docs.soljio.com/api/organization-reads/get-operations-queue): Get organization work queues; personal dismissals are not… Reference for the POST /queries/get_operations_queue endpoint in the Soljio Organization API. - [Get organization settings.](https://docs.soljio.com/api/organization-reads/get-organization-settings): Get organization settings. An organization-scoped read… Reference for the POST /queries/get_organization_settings endpoint in the Soljio Organization API. - [Get participant details.](https://docs.soljio.com/api/organization-reads/get-participant-details): Get participant details. An organization-scoped read using… Reference for the POST /queries/get_participant_details endpoint in the Soljio Organization API. - [Get payment capabilities.](https://docs.soljio.com/api/organization-reads/get-payment-capabilities): Get payment capabilities. An organization-scoped read using… Reference for the POST /queries/get_payment_capabilities endpoint in the Soljio Organization API. - [Get a private lesson booking with its lessons, family, guests and payments.](https://docs.soljio.com/api/organization-reads/get-private-lesson-booking): Get a private lesson booking with its lessons, family,… Reference for the POST /queries/get_private_lesson_booking endpoint in the Soljio Organization API. - [Get the card money that can still be refunded on a private lesson booking.](https://docs.soljio.com/api/organization-reads/get-private-lesson-card-refundable): Get the card money that can still be refunded on… Reference for the POST /queries/get_private_lesson_card_refundable endpoint in the Soljio Organization API. - [Get a family's students and usable lesson packs for booking on their behalf.](https://docs.soljio.com/api/organization-reads/get-private-lesson-household): Get a family's students and usable lesson packs for… Reference for the POST /queries/get_private_lesson_household endpoint in the Soljio Organization API. - [Get the card money that can still be refunded for a lesson pack bought online.](https://docs.soljio.com/api/organization-reads/get-private-lesson-pack-card-refundable): Get the card money that can still be… Reference for the POST /queries/get_private_lesson_pack_card_refundable endpoint in the Soljio Organization API. - [Get private lesson types, availability, pack types and the locations, instructors and resources they use.](https://docs.soljio.com/api/organization-reads/get-private-lesson-setup): Get private lesson types, availability, pack types and the… Reference for the POST /queries/get_private_lesson_setup endpoint in the Soljio Organization API. - [Get private lesson requests waiting on someone and the lessons in a range of up to two weeks.](https://docs.soljio.com/api/organization-reads/get-private-lessons-overview): Get private lesson requests waiting on someone and the… Reference for the POST /queries/get_private_lessons_overview endpoint in the Soljio Organization API. - [Get program details.](https://docs.soljio.com/api/organization-reads/get-program-details): Get program details. An organization-scoped read using JSON… Reference for the POST /queries/get_program_details endpoint in the Soljio Organization API. - [Get a class date's skills checklist: each student's marks on one checklist level.](https://docs.soljio.com/api/organization-reads/get-progress-roster): Get a class date's skills checklist: each student's marks on one… Reference for the POST /queries/get_progress_roster endpoint in the Soljio Organization API. - [Get report preparation status and summary.](https://docs.soljio.com/api/organization-reads/get-report): Get report preparation status and summary. An organization-scoped read… Reference for the POST /queries/get_report endpoint in the Soljio Organization API. - [Read a page of completed report rows.](https://docs.soljio.com/api/organization-reads/get-report-rows): Read a page of completed report rows. An organization-scoped read… Reference for the POST /queries/get_report_rows endpoint in the Soljio Organization API. - [Get schedule month summary.](https://docs.soljio.com/api/organization-reads/get-schedule-month): Get schedule month summary. An organization-scoped read using… Reference for the POST /queries/get_schedule_month endpoint in the Soljio Organization API. - [Get schedule week.](https://docs.soljio.com/api/organization-reads/get-schedule-week): Get schedule week. An organization-scoped read using JSON filter… Reference for the POST /queries/get_schedule_week endpoint in the Soljio Organization API. - [Get attendance, makeup and enrollment details for a class date.](https://docs.soljio.com/api/organization-reads/get-session-roster): Get attendance, makeup and enrollment details for a class date.… Reference for the POST /queries/get_session_roster endpoint in the Soljio Organization API. - [Get a complete class date roster with registration answers in one snapshot, for export.](https://docs.soljio.com/api/organization-reads/get-session-roster-export): Get a complete class date roster with registration answers… Reference for the POST /queries/get_session_roster_export endpoint in the Soljio Organization API. - [Get sms settings.](https://docs.soljio.com/api/organization-reads/get-sms-settings): Get sms settings. An organization-scoped read using JSON filter… Reference for the POST /queries/get_sms_settings endpoint in the Soljio Organization API. - [Get the school's waiver draft, published version and requirement settings.](https://docs.soljio.com/api/organization-reads/get-waiver-settings): Get the school's waiver draft, published version and requirement… Reference for the POST /queries/get_waiver_settings endpoint in the Soljio Organization API. - [List audit events.](https://docs.soljio.com/api/organization-reads/list-audit-events): List audit events. An organization-scoped read using JSON filter… Reference for the POST /queries/list_audit_events endpoint in the Soljio Organization API. - [List class dates.](https://docs.soljio.com/api/organization-reads/list-class-dates): List class dates. An organization-scoped read using JSON filter… Reference for the POST /queries/list_class_dates endpoint in the Soljio Organization API. - [List conversations.](https://docs.soljio.com/api/organization-reads/list-conversations): List conversations. An organization-scoped read using JSON filter… Reference for the POST /queries/list_conversations endpoint in the Soljio Organization API. - [List custom domains.](https://docs.soljio.com/api/organization-reads/list-custom-domains): List custom domains. An organization-scoped read using JSON… Reference for the POST /queries/list_custom_domains endpoint in the Soljio Organization API. - [List programs eligible for promo code scope selection.](https://docs.soljio.com/api/organization-reads/list-discount-program-choices): List programs eligible for promo code scope selection.… Reference for the POST /queries/list_discount_program_choices endpoint in the Soljio Organization API. - [List the registration questions staff must collect when enrolling into offerings.](https://docs.soljio.com/api/organization-reads/list-enrollment-intake-questions): List the registration questions staff must collect… Reference for the POST /queries/list_enrollment_intake_questions endpoint in the Soljio Organization API. - [List the payments recorded against enrollments, with their processor references.](https://docs.soljio.com/api/organization-reads/list-enrollment-payments): List the payments recorded against enrollments, with their… Reference for the POST /queries/list_enrollment_payments endpoint in the Soljio Organization API. - [List household participants.](https://docs.soljio.com/api/organization-reads/list-household-participants): List household participants. An organization-scoped read… Reference for the POST /queries/list_household_participants endpoint in the Soljio Organization API. - [List import batches.](https://docs.soljio.com/api/organization-reads/list-import-batches): List import batches. An organization-scoped read using JSON… Reference for the POST /queries/list_import_batches endpoint in the Soljio Organization API. - [List instructors, newest first, with their status and linked school account.](https://docs.soljio.com/api/organization-reads/list-instructors): List instructors, newest first, with their status and linked school… Reference for the POST /queries/list_instructors endpoint in the Soljio Organization API. - [List location options.](https://docs.soljio.com/api/organization-reads/list-location-options): List location options. An organization-scoped read using JSON… Reference for the POST /queries/list_location_options endpoint in the Soljio Organization API. - [List message delivery attempts and recipient addresses.](https://docs.soljio.com/api/organization-reads/list-notification-deliveries): List message delivery attempts and recipient addresses.… Reference for the POST /queries/list_notification_deliveries endpoint in the Soljio Organization API. - [List blocked recipients and their message scopes.](https://docs.soljio.com/api/organization-reads/list-notification-suppressions): List blocked recipients and their message scopes. An… Reference for the POST /queries/list_notification_suppressions endpoint in the Soljio Organization API. - [List notification templates.](https://docs.soljio.com/api/organization-reads/list-notification-templates): List notification templates. An organization-scoped read… Reference for the POST /queries/list_notification_templates endpoint in the Soljio Organization API. - [List offering options.](https://docs.soljio.com/api/organization-reads/list-offering-options): List offering options. An organization-scoped read using JSON… Reference for the POST /queries/list_offering_options endpoint in the Soljio Organization API. - [List participant profiles.](https://docs.soljio.com/api/organization-reads/list-participant-profiles): List participant profiles. An organization-scoped read… Reference for the POST /queries/list_participant_profiles endpoint in the Soljio Organization API. - [List whether students have a current signed waiver.](https://docs.soljio.com/api/organization-reads/list-participant-waiver-statuses): List whether students have a current signed waiver.… Reference for the POST /queries/list_participant_waiver_statuses endpoint in the Soljio Organization API. - [List payment provider states.](https://docs.soljio.com/api/organization-reads/list-payment-provider-states): List payment provider states. An organization-scoped… Reference for the POST /queries/list_payment_provider_states endpoint in the Soljio Organization API. - [List payment webhooks.](https://docs.soljio.com/api/organization-reads/list-payment-webhooks): List payment webhooks. An organization-scoped read using JSON… Reference for the POST /queries/list_payment_webhooks endpoint in the Soljio Organization API. - [List instructor private lesson hours where lesson types let instructors maintain their own availability.](https://docs.soljio.com/api/organization-reads/list-private-lesson-instructor-hours): List instructor private lesson hours where… Reference for the POST /queries/list_private_lesson_instructor_hours endpoint in the Soljio Organization API. - [List lesson packs sold to families, newest first, with balances.](https://docs.soljio.com/api/organization-reads/list-private-lesson-packs): List lesson packs sold to families, newest first, with… Reference for the POST /queries/list_private_lesson_packs endpoint in the Soljio Organization API. - [List bookable private lesson start times per day for up to six weeks.](https://docs.soljio.com/api/organization-reads/list-private-lesson-slots): List bookable private lesson start times per day for up to… Reference for the POST /queries/list_private_lesson_slots endpoint in the Soljio Organization API. - [List every private lesson type staff can book, published or not.](https://docs.soljio.com/api/organization-reads/list-private-lesson-types): List every private lesson type staff can book, published… Reference for the POST /queries/list_private_lesson_types endpoint in the Soljio Organization API. - [List a program's registration questions, including archived ones.](https://docs.soljio.com/api/organization-reads/list-program-intake-questions): List a program's registration questions, including… Reference for the POST /queries/list_program_intake_questions endpoint in the Soljio Organization API. - [List program options.](https://docs.soljio.com/api/organization-reads/list-program-options): List program options. An organization-scoped read using JSON… Reference for the POST /queries/list_program_options endpoint in the Soljio Organization API. - [List report cards: the skills checklists students are marked against.](https://docs.soljio.com/api/organization-reads/list-report-card-templates): List report cards: the skills checklists students are… Reference for the POST /queries/list_report_card_templates endpoint in the Soljio Organization API. - [List resources.](https://docs.soljio.com/api/organization-reads/list-resources): List resources. An organization-scoped read using JSON filter… Reference for the POST /queries/list_resources endpoint in the Soljio Organization API. - [List schedule rules.](https://docs.soljio.com/api/organization-reads/list-schedule-rules): List schedule rules. An organization-scoped read using JSON… Reference for the POST /queries/list_schedule_rules endpoint in the Soljio Organization API. - [List credential metadata without secrets.](https://docs.soljio.com/api/organization-reads/list-service-tokens): List credential metadata without secrets. An organization-scoped… Reference for the POST /queries/list_service_tokens endpoint in the Soljio Organization API. - [List eligible class dates for an enrollment transfer or makeup credit.](https://docs.soljio.com/api/organization-reads/list-session-operation-targets): List eligible class dates for an enrollment transfer… Reference for the POST /queries/list_session_operation_targets endpoint in the Soljio Organization API. - [List active school members an instructor can be linked to.](https://docs.soljio.com/api/organization-reads/list-teaching-accounts): List active school members an instructor can be linked to. An… Reference for the POST /queries/list_teaching_accounts endpoint in the Soljio Organization API. - [List terms with their dates, status and holidays.](https://docs.soljio.com/api/organization-reads/list-terms): List terms with their dates, status and holidays. An organization-scoped… Reference for the POST /queries/list_terms endpoint in the Soljio Organization API. - [Expand a weekly or fortnightly private lesson series into dates, with alternatives for dates that can't be booked.](https://docs.soljio.com/api/organization-reads/plan-private-lesson-series): Expand a weekly or fortnightly private lesson series into… Reference for the POST /queries/plan_private_lesson_series endpoint in the Soljio Organization API. - [Price a private lesson booking exactly as create_private_lesson_booking will.](https://docs.soljio.com/api/organization-reads/quote-private-lesson): Price a private lesson booking exactly as… Reference for the POST /queries/quote_private_lesson endpoint in the Soljio Organization API. - [Price changing which students attend upcoming lessons before change_private_lesson_roster.](https://docs.soljio.com/api/organization-reads/quote-private-lesson-roster-change): Price changing which students attend upcoming… Reference for the POST /queries/quote_private_lesson_roster_change endpoint in the Soljio Organization API. - [Price going ahead with a booking without some invited guests before continue_private_lesson_without_guests.](https://docs.soljio.com/api/organization-reads/quote-private-lesson-without-guests): Price going ahead with a booking without some… Reference for the POST /queries/quote_private_lesson_without_guests endpoint in the Soljio Organization API. - [Search enrollment and balance details.](https://docs.soljio.com/api/organization-reads/search-enrollments): Search enrollment and balance details. An organization-scoped… Reference for the POST /queries/search_enrollments endpoint in the Soljio Organization API. - [Search offerings.](https://docs.soljio.com/api/organization-reads/search-offerings): Search offerings. An organization-scoped read using JSON filter… Reference for the POST /queries/search_offerings endpoint in the Soljio Organization API. - [Search organization.](https://docs.soljio.com/api/organization-reads/search-organization): Search organization. An organization-scoped read using JSON… Reference for the POST /queries/search_organization endpoint in the Soljio Organization API. - [Search participants.](https://docs.soljio.com/api/organization-reads/search-participants): Search participants. An organization-scoped read using JSON… Reference for the POST /queries/search_participants endpoint in the Soljio Organization API. - [Search programs.](https://docs.soljio.com/api/organization-reads/search-programs): Search programs. An organization-scoped read using JSON filter… Reference for the POST /queries/search_programs endpoint in the Soljio Organization API. ## Changelog - [Agent views and events](https://docs.soljio.com/changelog/2026-11-13-agent-views-and-events): AI agents can now show you your schedule, rosters, and proposed changes, and can be told when something happens at your school. - [API and AI agent connections](https://docs.soljio.com/changelog/2026-11-12-api-and-agents): Your own tools and AI agents can now work with your school's data. - [Search reaches every dashboard page](https://docs.soljio.com/changelog/2026-11-12-dashboard-search): Dashboard search now finds the pages and settings sections that sit inside other pages. - [Instructor profiles and private-lesson booking](https://docs.soljio.com/changelog/2026-11-11-instructor-profiles): Instructors can have a public page, and families can book private lessons from it. - [A Team page for instructors](https://docs.soljio.com/changelog/2026-10-30-team-page): Instructors now have their own home on the **Team** page. - [A new school site and account settings](https://docs.soljio.com/changelog/2026-10-29-school-site-and-accounts): Your school's public site has a new design that carries your branding. - [Private lessons](https://docs.soljio.com/changelog/2026-10-28-private-lessons): Offer one-on-one lessons alongside your group sessions. - [A new calendar and a faster attendance page](https://docs.soljio.com/changelog/2026-10-13-calendar-and-attendance): Daily work in the dashboard got a round of changes. ## Families - [Families](https://docs.soljio.com/families): Guides for parents and guardians on creating an account, enrolling students, paying, following progress, and booking private lessons at a Soljio school. - [Create an account and sign in](https://docs.soljio.com/families/create-an-account): Create a Soljio account with your email or Google, confirm it, sign in later, and reset a password you have forgotten. - [Claim your household](https://docs.soljio.com/families/claim-your-household): Use the link in your school's email to take over the family account it created for you, with the right email address. - [Find a program and a session](https://docs.soljio.com/families/find-and-enroll): Browse your school's programs, narrow sessions by term, location, day, and time, and read a session's schedule, price, and availability. - [Enroll in a session](https://docs.soljio.com/families/enroll-in-a-session): Fill in the enrollment form for a student, answer registration questions, accept the waiver, and finish enrolling with or without an account. - [Checkout, payment, and confirmation](https://docs.soljio.com/families/checkout-and-payment): Pay for a session online, apply a promo code, understand the 30-minute hold, and read your enrollment confirmation page. - [Waitlists and withdrawing](https://docs.soljio.com/families/waitlists-and-withdrawing): What happens when a session is full, how a waitlist spot is offered to you, and how to withdraw from a session and release your place. - [Manage your students](https://docs.soljio.com/families/your-students): Add family members, keep emergency and health details current, see classes and next dates, and remove a student from the My family page. - [School waiver](https://docs.soljio.com/families/school-waiver): Read and accept your school's liability waiver, see which version you accepted, and re-accept it when the school publishes a new one. - [Report cards and progress](https://docs.soljio.com/families/report-cards): See which skills your student has attempted and completed, their current level, and when the instructor last updated their progress. - [Meet instructors and browse private lessons](https://docs.soljio.com/families/instructors-and-private-lessons): Read about a school's instructors, compare its private lessons before you sign in, and start a booking from a lesson or an instructor's profile. - [Book a private lesson](https://docs.soljio.com/families/private-lessons): Choose a lesson, pick a date and time, add students or invite a friend, then book and pay. Includes what happens when the school must approve. - [Manage private lessons](https://docs.soljio.com/families/manage-private-lessons): Pay a balance, reschedule or cancel a lesson, change which students attend, switch to a different lesson, and withdraw a request. - [Lesson packs](https://docs.soljio.com/families/lesson-packs): Buy a pack of private lesson credits up front, see how many credits are left, and use them when you book a private lesson. - [Shared lesson invitations](https://docs.soljio.com/families/shared-lesson-invitations): Invite a friend's family to a group private lesson, or accept or decline an invitation you received, and handle guests who can't make it. - [Invoices and balances](https://docs.soljio.com/families/invoices): Open an invoice from your email, see what is still owed for each class, and pay the balance online when the school accepts payment. - [Messages you receive](https://docs.soljio.com/families/messages-you-receive): The emails Soljio sends families for enrollments, waitlists, invoices, account claims, and private lessons, and what each one asks you to do. - [Account settings](https://docs.soljio.com/families/account-settings): Check your name and email, add or remove a profile photo, and change your password from the Account settings page. ## Schools - [Run your school on Soljio](https://docs.soljio.com/schools): Guides for owners, admins, staff, and instructors, from creating your school to daily attendance and getting paid. ### Getting started - [Getting started](https://docs.soljio.com/schools/getting-started): Create your school, learn who can do what, see what families see, and find your way around the dashboard. - [Create your school](https://docs.soljio.com/schools/getting-started/create-your-school): Start a school on Soljio. Enter your school's details, start your subscription, add your logo and colors, and open your dashboard. - [Roles and permissions](https://docs.soljio.com/schools/getting-started/roles-and-permissions): See what owners, admins, staff, and instructors can open and change in Soljio, and how to invite someone or change their role. - [Your school's website](https://docs.soljio.com/schools/getting-started/your-school-website): See what families see on your school's public pages, and where to change your logo, colors, welcome line, address, and instructor directory. - [Dashboard tour](https://docs.soljio.com/schools/getting-started/dashboard-tour): Find your way around the Soljio dashboard. Learn the menu, the search box, the New button, and the phone layout, and what your role sees. ### Catalog - [Catalog](https://docs.soljio.com/schools/catalog): Build what families sign up for. Create programs and sessions, group sessions into terms with holidays, and set up report-card templates. - [Programs](https://docs.soljio.com/schools/catalog/programs): Create and edit programs, the categories families browse. Set a status, write what families need to know, and archive a program you no longer offer. - [Sessions](https://docs.soljio.com/schools/catalog/sessions): Schedule a program as a session with class dates, capacity, location, and instructors, publish it for enrollment, and change its schedule later. - [Terms and holidays](https://docs.soljio.com/schools/catalog/terms-and-holidays): Group sessions into a term with start and end dates, add holidays that every session in the term skips, and understand what happens to class dates. - [Report-card templates](https://docs.soljio.com/schools/catalog/report-card-templates): Set up report cards with levels and skills so every instructor marks the same checklist, and control which cards are in use. ### Daily work - [Daily work](https://docs.soljio.com/schools/daily-work): Run each class day. Start from Today, take attendance, track progress, and manage students, households, enrollments, waitlists, and makeups. - [Today and My classes](https://docs.soljio.com/schools/daily-work/today): Start the day from Today to see the class dates happening now and the tasks that need action, or from My classes if you teach. - [Calendar and class dates](https://docs.soljio.com/schools/daily-work/calendar-and-class-dates): Browse class dates by day, week, or month, open a roster, and change or cancel a single class date without touching the rest of the session. - [Take attendance](https://docs.soljio.com/schools/daily-work/attendance): Mark each student present, late, absent, or excused for a class date, mark everyone present at once, and catch classes with attendance still open. - [Track progress with report cards](https://docs.soljio.com/schools/daily-work/progress-and-report-cards): Mark each student's skills attempted or completed during class so the whole team tracks progress the same way, and families see the same marks. - [Students and households](https://docs.soljio.com/schools/daily-work/students-and-households): Find students, add them, edit their details and safety information, and manage the household and family access linked to each one. - [Enrollments](https://docs.soljio.com/schools/daily-work/enrollments): Review who is signed up, enroll a student by phone or at the desk, and cancel or transfer enrollments, with the statuses and rules Soljio applies. - [Waitlists](https://docs.soljio.com/schools/daily-work/waitlists): How full sessions fill a waitlist, how students move up when a seat opens, and how to promote someone yourself from the Enrollments page or a roster. - [Makeups](https://docs.soljio.com/schools/daily-work/makeups): Give a student a makeup credit for a missed class and reserve a seat for them on another class date, with the rules Soljio checks first. ### Private lessons - [Private lessons](https://docs.soljio.com/schools/private-lessons): Set up one-on-one and small-group lessons families can book online, manage the bookings that come in, book for a family, and sell lesson packs. - [Lesson types](https://docs.soljio.com/schools/private-lessons/lesson-types): Create the private lessons families can book, and set each one's length, group size, price, instructors, booking rules, deadlines, and reminders. - [Availability](https://docs.soljio.com/schools/private-lessons/availability): Set a location's opening hours and closures, give each instructor weekly hours and time off, and see which spaces and equipment lessons use. - [Bookings](https://docs.soljio.com/schools/private-lessons/bookings): Review the week's private lessons, answer requests, collect payment, reschedule, change students, take attendance, and cancel with the right refund. - [Book for a family](https://docs.soljio.com/schools/private-lessons/book-for-a-family): Book a private lesson for a family by phone or at the desk, choose payment, repeat the lesson weekly, and book outside the usual rules when needed. - [Lesson packs](https://docs.soljio.com/schools/private-lessons/lesson-packs): Create lesson packs families prepay for, sell a pack at the desk, see each family's balance of credits, and refund a pack. ### Messaging - [Messaging](https://docs.soljio.com/schools/messaging): Read family conversations in the inbox, set up a school number for texts, and understand the emails Soljio sends and how to check their delivery. - [Inbox](https://docs.soljio.com/schools/messaging/inbox): Open the inbox to read family conversations by text, see who is assigned to each one, and assign a conversation to yourself. - [Text messaging](https://docs.soljio.com/schools/messaging/text-messaging): Register your school for text messaging, submit the application for carrier review, choose a school number, and follow each setup status. - [Notifications](https://docs.soljio.com/schools/messaging/notifications): See which emails Soljio sends to families and staff, what triggers each one, and how to turn off enrollment and waitlist emails. - [Email and delivery](https://docs.soljio.com/schools/messaging/email-and-delivery): Set the sender name, reply-to address, and mailing address on your emails, review delivery attempts, and block or unblock a recipient. ### Business - [Business](https://docs.soljio.com/schools/business): Connect online payments, record cash and checks on Pro and Scale, invoice families, handle refunds, offer discounts, and read the reports that show how your school is doing. - [Accept online payments](https://docs.soljio.com/schools/business/accept-payments): Connect your school's payment account, finish setup, review balances and payouts, and respond when Soljio asks for more details. - [Record a payment](https://docs.soljio.com/schools/business/record-a-payment): Log cash, a check, or a card reader payment against an enrollment on the Pro and Scale plans so the family's balance is correct, and see what each payment row shows. - [Invoices](https://docs.soljio.com/schools/business/invoices): Group a household's open balances into one invoice, add credits or charges with a reason, and see which invoices are open, partly paid, or paid. - [Refunds](https://docs.soljio.com/schools/business/refunds): Learn what cancelling an enrollment does to payments, where to refund online payments, and how refunds work for private lessons and lesson packs. - [Discounts and promo codes](https://docs.soljio.com/schools/business/discounts): Set a sibling discount for families who pay for several students together, create promo codes, and turn codes on or off. - [Reports and exports](https://docs.soljio.com/schools/business/reports): Generate an enrollment, capacity, attendance, and collections report for a date range, and download CSV files of your school's records. ### Administration - [Administration](https://docs.soljio.com/schools/administration): Set up and look after your school. School settings, locations, domains, your team, waivers, registration questions, imports, exports, integrations, the audit log, and your plan. - [Settings](https://docs.soljio.com/schools/administration/settings): Change your school's name, timezone, defaults, logo, email sender, locations, and resources, and find the other settings pages. - [Locations and resources](https://docs.soljio.com/schools/administration/locations-and-resources): Add the places you teach and the lanes, rooms, or equipment you schedule, then use them for sessions, class dates, and private lessons. - [Domains](https://docs.soljio.com/schools/administration/domains): Find your school's web address, change it, and check whether your own domain is connected and ready for families. - [Team and instructors](https://docs.soljio.com/schools/administration/team-and-instructors): Add instructors, link each one to a sign-in account, invite staff and admins, change roles, and archive an instructor who has left. - [Instructor profiles](https://docs.soljio.com/schools/administration/instructor-profiles): Give each instructor a photo, bio, and shareable link. Publish profiles, show an instructor directory on your website, and copy a profile link. - [Waivers](https://docs.soljio.com/schools/administration/waivers): Write and publish the liability waiver families accept when they register, publish a new version, and see who has accepted which version. - [Registration questions](https://docs.soljio.com/schools/administration/registration-questions): Ask families extra questions when they enroll in a program. Add short-answer, yes or no, and choose-one questions, and reorder or archive them. - [Message delivery](https://docs.soljio.com/schools/administration/communications): Check whether the emails and texts your school sends were delivered, read the delivery history for one message, and block or unblock a recipient. - [Integrations](https://docs.soljio.com/schools/administration/integrations): Give another tool access to your school's data with a token, choose exactly what it can do, and rotate or revoke it later. - [Connected agents](https://docs.soljio.com/schools/administration/connected-agents): Approve an AI agent to work in your school, see what each connected agent can do, and disconnect one. - [Import records](https://docs.soljio.com/schools/administration/imports): Bring households, students, programs, sessions, class dates, and enrollments into Soljio from CSV files. Validate first, then import. - [Data exports](https://docs.soljio.com/schools/administration/data-exports): Download your school's households, students, programs, sessions, class dates, enrollments, attendance, skill progress, and waiver acceptances as CSV files. - [Audit log](https://docs.soljio.com/schools/administration/activity-log): Review who changed what, and when, across your school. Filter by person, action, record, and dates, and open the record behind an entry. - [Plan and billing](https://docs.soljio.com/schools/administration/plan-and-billing): Compare the Launch, Grow, Pro, and Scale plans, change your plan, check your current period and invoices, update your card, apply a code, and cancel. - [When school access is paused](https://docs.soljio.com/schools/administration/school-access-paused): What owners, admins, staff, and instructors see when a school's Soljio access is paused, how to read rosters and safety details meanwhile, and how to restore access. ## RSS Feeds - [Soljio Docs — Changelog](https://docs.soljio.com/changelog/rss.xml) ## Agent skills - [soljio-docs](https://docs.soljio.com/.well-known/agent-skills/soljio-docs/SKILL.md): Read the Soljio Docs instead of answering from memory. Guides for running a swim school on Soljio, signing up as a family, and building on the Soljio API. Use when a task involves Soljio Docs: how it works, how to set it up or configure it, or its API. ## Agent resources - [llms-full.txt](https://docs.soljio.com/llms-full.txt): The full Markdown of every page in one file. - [Page Markdown](https://docs.soljio.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown. - [JSON API](https://docs.soljio.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.soljio.com/openapi.json. - [Agent skills](https://docs.soljio.com/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes. - [API catalog](https://docs.soljio.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here. - [AI catalog](https://docs.soljio.com/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs). - [agent-readability.json](https://docs.soljio.com/agent-readability.json): Manifest of every agent-facing artifact on this site. - [Sitemap](https://docs.soljio.com/sitemap.xml): Every indexable page URL with its last-modified date.