Skip to content
Soljio Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Build on Soljio

Connect your swim school's own systems and AI agents to Soljio with the HTTP API, service tokens, and the MCP server.

Soljio’s developer tools connect a swim school’s own systems and AI agents to its Soljio workspace. You can read programs, sessions, class dates, students, and enrollments, run filtered queries, and run the same commands staff run in the dashboard.

What people build

  • Sync a school’s programs, schedules, rosters, or enrollments with another system.
  • Build reports or dashboards from a school’s own data.
  • Let an AI agent answer questions about a school’s schedule, or prepare changes for staff to approve.

Two ways in

Both paths reach the same operations, run the same checks, and act on exactly one school.

HTTP API MCP server
Best for Scripts, back-office syncs, and your own software AI agents such as ChatGPT or Claude
Address https://api.soljio.com/v0 https://soljio.com/mcp
Credential A service token sent as a bearer token An OAuth connection that a school owner or admin approves
Created by An owner or admin under Dashboard → Settings → Integrations An owner or admin on the Connect an agent page
Access The scopes chosen when the token is created The access chosen when the agent is approved, never more than that person’s role allows

The HTTP API accepts service tokens only. The MCP server accepts agent connections only. A token from one does not work on the other.

Ground rules

  • One school per credential. A token or agent connection belongs to a single school. Requests never name the school, and a request body cannot override it.
  • Scopes are additive. A credential can do only what it was granted. Write access never implies read access. See Scopes.
  • JSON in, JSON out. Properties use snake_case, identifiers are opaque strings, and timestamps are RFC 3339 UTC. See Requests and responses.
  • Writes are retry-safe. Every command needs an Idempotency-Key header. See Idempotency.
  • Risky changes are previewed first. Schedule-changing commands are applied with an approval token from a preview. See Previews and approvals.

Names in the API

The API uses the names in its contract. The dashboard uses Soljio’s everyday words for the same things.

In the dashboard In the API
Program programs
Session (one enrollable run of a program) offerings
Class date (one meeting of a session) sessions
Student participants
Enrollment enrollments
Instructor instructors
Location locations

Pages in this section use the API’s names inside code and the dashboard’s words in prose.

Where to go next

Was this page helpful?