Update Service

This endpoint updates a service. Only the fields present in the request are changed (partial update).

Important Notes

  • provider_ids replaces the list of providers that offer the service.
  • Use the activate and deactivate endpoints to change active.
  • An id that belongs to another company answers 404, the same as an unknown id.

Errors Dictionary

StatusErrorDetailDescription
400invalid_bodyexpected_objectRequest body is not a JSON object.
400invalid_name—name is blank or invalid.
400invalid_price—price is negative.
400invalid_duration—duration is out of range.
400invalid_online_payment_mode—online_payment.mode is invalid or not allowed for the company.
400invalid_online_payment_amount—online_payment.amount must be positive for MANDATORY_PARTIAL.
401unauthorizedinvalid_api_keyMissing or invalid Bearer token.
401unauthorizedapi_config_inactiveAPI access is inactive for this company.
403forbiddenscope_deniedAPI key lacks services:write scope.
403cross_company_service_category—service_category_id belongs to another company.
403cross_company_providers—A provider in provider_ids belongs to another company.
403outcall_not_supported—The company's plan does not allow at-home services.
403is_video_not_supported—The company's plan does not allow video services.
404service_not_found—Service not found, or it belongs to another company.
422inactive_providers—A provider in provider_ids is inactive.
422name_too_long—name exceeds 255 characters.
429rate_limitedburst_limit_exceededPer-minute request limit exceeded.
429rate_limiteddaily_quota_exceededDaily request quota exceeded.
502upstream_unavailableconnection_failedThe upstream service is unavailable.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required
≥ 1

Service unique identifier.

Body Params

Every field is optional; only the fields present in the request are changed.

string
length ≤ 255
string | null
integer

Category of the service. Must belong to the company.

number
≥ 0
integer
5 to 1439

Duration in minutes.

keywords
array of strings
length ≤ 10

Alternative names used by search (2 to 50 characters each).

keywords
provider_ids
array of integers

Providers that offer the service. Must belong to the company and be active.

provider_ids
boolean

Whether clients can book the service online.

online_payment
object

Online payment settings. Optional: on create, when omitted the service is not payable online (mode: NOT_AVAILABLE); on update, when omitted the current setting is kept.

boolean

Whether the booking site shows the price.

boolean

Whether the booking site shows the duration.

boolean

Whether the service is delivered by video call. Subject to the company's plan.

boolean

Whether the service is delivered at the client's address. Subject to the company's plan.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json