API Reference
Services
Manage reusable service templates with pricing and warranty defaults
A service is a reusable template for the work you do — "Standard Diagnostic", "Battery Replacement", "Annual Tune-Up". Each service carries its own pricing model (fixed, hourly rate, or variable) and optional warranty defaults that flow through to quotes and invoices.
Endpoints
- GET
/organisations/{orgId}/services— List service templates (paginated) - POST
/organisations/{orgId}/services— Create service template - GET
/organisations/{orgId}/services/{serviceId}— Get service - PUT
/organisations/{orgId}/services/{serviceId}— Update service - DELETE
/organisations/{orgId}/services/{serviceId}— Delete service
Required scopes: services:read / services:write / services:delete.
List is ordered by title and supports search (matches title and description)
plus cursor pagination via limit and startAfter.
priceType values: fixed, rate, variable, unset. priceTimeRate
includes year. warrantyPeriod is days / weeks / months / years
(plural, matching the app).
Pricing models
priceType | Meaning |
|---|---|
fixed | A flat price regardless of duration |
rate | A per-unit rate — set priceTimeRate to hour, day, week, month, or year |
unset | No pricing model selected yet |
variable | Quoted on a per-job basis; the price field is treated as a starting point |
Machine-readable version: OpenAPI spec.