update_services

Update one or more services for a building. Each entry requires a serviceId and at least one field to update; fields left out keep their current value.

Input

Parameter	Type	Required	Description
buildingId	string	Yes	The ID of the building the services belong to
services	Service[]	Yes	Array of services to update - Service

Service

Field	Type	Required	Description
serviceId	string	Yes	The ID of the service to update
name	string	No	Display name of the service (3-64 characters)
amountCents	number	No	Price in the smallest currency unit (e.g., pence, cents). Includes VAT unless the service was set up net outside the API.
amountCurrency	string	No	ISO 4217 currency code (e.g., GBP, EUR)
amountType	AmountType	No	Set to GROSS to move a net service to gross pricing. A service cannot be moved back to net. - AmountType
applicationUnit	ApplicationUnit	No	How the service is charged. A per-billing-period service can be moved to one of these, but not back. Moving a service to another application unit clears its schedule. - ApplicationUnit
occurrenceUnit	OccurrenceUnit	No	How often the service recurs. Only for PER_UNIT_OF_SERVICE services, which must end up with both or neither of occurrenceUnit and occurrenceFrequency. - OccurrenceUnit
occurrenceFrequency	number	No	The number of occurrence units between charges, at least 1. Only for PER_UNIT_OF_SERVICE services.
prorationPolicy	ProrationPolicy	No	What a partial final occurrence charges. Only for PER_UNIT_OF_SERVICE services. - ProrationPolicy
vatCodeId	string	No	The ID of a VAT code from the building’s workspace
generalLedgerId	string	No	The uuid of a general ledger from the building’s workspace, as get_service returns it. When invoicing is enabled for the workspace, any update to a service without a ledger must give one.
chargeTypeId	string	No	The ID of a finance charge type available to the workspace’s organisation, used to classify the service

AmountType

Value	Description
GROSS	Amount includes VAT

ApplicationUnit

Value	Description
PER_BOOKING	Charged once per booking
PER_UNIT_OF_SERVICE	Charged on a recurring schedule, such as monthly

OccurrenceUnit

Value	Description
DAYS	Recurs every given number of days
WEEKS	Recurs every given number of weeks
MONTHS	Recurs every given number of months, on the day of the month the service starts

ProrationPolicy

Value	Description
FULL_OCCURRENCE	Every occurrence is charged in full
PRO_RATA	A partial final occurrence is charged for the share of its days within the booking

Output

Field	Type	Description
content	ContentItem[]	Array of content items returned by the tool - ContentItem
isError	boolean	Whether the tool execution resulted in an error

ContentItem

Field	Type	Description
type	'text'	Content type (currently only ‘text’ is supported)
text	string	The text content to display