service42 ops

Service API

Service marketplace — bookings, providers, service types, and scheduling.

Queries

QUERY

availableRequests

#

Browse available requests for a service I offer.

Arguments

  • serviceId!
  • pagination
Returns!
QUERY

browseCategories

#

Browse active service categories.

Arguments

  • parentId
Returns[!]!
QUERY

browseServices

#

Browse active services in a category.

Arguments

  • categoryId!
Returns[!]!
QUERY

myOffers

#

List my submitted offers.

Arguments

  • status
  • limitInt
  • offsetInt
Returns[!]!
QUERY

myProviderProfile

#

Get my provider profile.

Returns
QUERY

myServiceRequests

#

List my service requests.

Arguments

  • status
  • pagination
Returns!
QUERY

pendingServiceProviders

#

List providers pending approval.

Arguments

  • pagination
Returns!
QUERY

requestOffers

#

List offers for a service request (customer only).

Arguments

  • requestId!
Returns[!]!
QUERY

rootServiceCategories

#

List root-level service categories (no parent).

Arguments

  • includeInactiveBoolean
  • pagination
Returns!
QUERY

service

#

Get a service by ID.

Arguments

  • id!
Returns
QUERY

serviceCategories

#

List service categories with pagination.

Arguments

  • parentId
  • includeInactiveBoolean
  • pagination
Returns!
QUERY

serviceCategory

#

Get a service category by ID.

Arguments

  • id!
Returns
QUERY

serviceMarketplaceHealth

#

Service health check query.

ReturnsString!
QUERY

serviceProvider

#

Get a service provider by ID.

Arguments

  • id!
Returns
QUERY

serviceProviders

#

List service providers with pagination and filters.

Arguments

  • status
  • searchString
  • pagination
Returns!
QUERY

serviceQuestion

#

Get a service question by ID.

Arguments

  • id!
Returns
QUERY

serviceQuestions

#

Get questions for a service (for request form).

Arguments

  • serviceId!
Returns[!]!
QUERY

servicesByCategory

#

List services by category with pagination.

Arguments

  • categoryId!
  • includeInactiveBoolean
  • pagination
Returns!

Mutations

MUTATION

approveServiceProvider

#

Approve a service provider (set status to Active).

Arguments

  • input!
Returns!
MUTATION

cancelServiceRequest

#

Cancel a service request.

Arguments

  • requestId!
Returns!
MUTATION

confirmCompletion

#

Customer confirms completion.

Arguments

  • requestId!
Returns!
MUTATION

createService

#

Create a new service.

Arguments

  • input!
Returns!
MUTATION

createServiceCategory

#

Create a new service category.

Arguments

  • input!
Returns!
MUTATION

createServiceQuestion

#

Create a new service question.

Arguments

  • input!
Returns!
MUTATION

createServiceRequest

#

Create a new service request.

Arguments

  • input!
Returns!
MUTATION

deleteService

#

Delete a service (soft delete).

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteServiceCategory

#

Delete a service category (soft delete).

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteServiceQuestion

#

Delete a service question.

Arguments

  • id!
ReturnsBoolean!
MUTATION

generateServiceQuestionTemplate

#

Ask the tenant's default LLM for a starter set of intake questions for a new service category. The admin reviews, edits, and accepts; this mutation does NOT persist the questions. Admin-only. Requires the tenant to have serviceQuestionGenEnabled turned on under Settings → AI Features and at least one configured AI provider with a remaining monthly budget.

Arguments

  • input!
Returns!
MUTATION

markServiceComplete

#

Provider marks a service as complete.

Arguments

  • requestId!
  • completionNotesString
Returns!
MUTATION

raiseDispute

#

Customer raises a dispute.

Arguments

  • requestId!
  • reasonString!
Returns!
MUTATION

registerAsProvider

#

Register as a service provider.

Arguments

  • input!
Returns!
MUTATION

reorderServiceQuestions

#

Reorder service questions.

Arguments

  • input!
ReturnsBoolean!
MUTATION

selectOffer

#

Select an offer for a service request.

Arguments

  • offerId!
Returns!
MUTATION

serviceMarketplacePing

#

Service health check mutation.

ReturnsString!
MUTATION

submitOffer

#

Submit an offer on a service request.

Arguments

  • input!
Returns!
MUTATION

suspendServiceProvider

#

Suspend a service provider.

Arguments

  • input!
Returns!
MUTATION

unsuspendServiceProvider

#

Unsuspend a service provider (set status back to Active).

Arguments

  • providerId!
Returns!
MUTATION

updateMyProviderProfile

#

Update provider profile.

Arguments

  • input!
Returns!
MUTATION

updateService

#

Update an existing service.

Arguments

  • input!
Returns!
MUTATION

updateServiceCategory

#

Update an existing service category.

Arguments

  • input!
Returns!
MUTATION

updateServiceQuestion

#

Update an existing service question.

Arguments

  • input!
Returns!

Build the foundation once. Expand without limits.

BetterSuite is built for teams who see on-demand as a business — not a feature.