API Reference

The complete, always-current reference — every endpoint, parameter, request/response schema, and a “try it” console — is generated from the live API contract and served interactively. Pick your product:

This is the single source of truth for request/response shapes. It’s generated from the API itself, so it never drifts from what the service actually does.

Base URL: https://api.baywise.ai/v1 · Auth: Authorization: Bearer bw_live_… (create in Settings → Developer).

What’s in each product

Scheduler — Jobs · Steps · Technicians · Bays · Service Catalog · Attendance · Day Close · Workshop Settings. See the Scheduler API guide for concepts, when to use it, a typical flow, and MCP read access.

Payments — Engagements · Transactions (collections & payments) · Collection links · Reconciliation. See the Payments API guide for concepts (including what reconciliation is and the confirm-then-commit void flow) and a typical flow.

Platform — Identity (/me) · Locations · Integrations · Webhooks (registration & management). See the Platform API guide for how to wire up the Platform layer before calling product endpoints.

Conventions

These apply across every endpoint — see Getting Started for detail:

Lists return { "data": [...], "next_cursor": … }; pass next_cursor back as ?cursor.
Send an Idempotency-Key header on creates for safe retries.
Sensitive actions use confirm-then-commit (a :prepare call returns a one-time grant for the real call).
Errors are RFC 7807 application/problem+json with a request_id.

Webhooks

To receive job and step events instead of polling, see Webhooks.