Update ExtraService

PUT

api

billing

extraservices

Update ExtraService

curl --request PUT \
  --url https://spaces.nexudus.com/api/billing/extraservices \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "BusinessId": 123,
  "Name": "<string>",
  "DisplayOrder": 123,
  "Price": 123,
  "ChargePeriod": 123,
  "CurrencyId": 123,
  "LastMinuteAdjustmentType": 123,
  "FromTime": 123,
  "ToTime": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/extraservices"

payload = {
    "Id": 123,
    "BusinessId": 123,
    "Name": "<string>",
    "DisplayOrder": 123,
    "Price": 123,
    "ChargePeriod": 123,
    "CurrencyId": 123,
    "LastMinuteAdjustmentType": 123,
    "FromTime": 123,
    "ToTime": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    BusinessId: 123,
    Name: '<string>',
    DisplayOrder: 123,
    Price: 123,
    ChargePeriod: 123,
    CurrencyId: 123,
    LastMinuteAdjustmentType: 123,
    FromTime: 123,
    ToTime: 123
  })
};

fetch('https://spaces.nexudus.com/api/billing/extraservices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Updates an existing ExtraService record. You must include the Id of the record to update along with all required fields.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the ExtraService-Edit role.

Enums

eChargePeriod — ChargePeriod values

Value	Name
1	Minutes
2	Days
3	Weeks
4	Months
5	Uses
6	FourWeekMonths

eLastMinuteDiscountType — LastMinuteAdjustmentType values

Value	Name
1	Disabled
2	Fixed
3	Gradual

Request Body

Required Fields

integer

required

The Id of the ExtraService record to update.

integer

required

ID of the business linked to this record.

string

required

Extra service name.

integer

required

Display order.

number

required

Unit price amount.

integer

required

Charge period.

integer

required

ID of the currency linked to this record.

integer

required

Last-minute discount type.

Optional Fields

string

Free-text description of this extra service.

string

Invoice line display text.

boolean

Whether the price is visible on the portal and app.

integer[]

List of resource types linked to this record.

integer[]

The added resource types value for this extra service.

integer[]

The removed resource types value for this extra service.

number

Credit price.

number

Maximum price cap.

boolean

Use as the default price for matched resource types if more than one price applies.

boolean

Use per-night pricing.

integer

ID of the tax rate linked to this record.

integer

ID of the reduced tax rate linked to this record.

integer

ID of the exempt tax rate linked to this record.

integer

ID of the financial account linked to this record.

integer

Start time restriction (minutes from midnight).

integer

End time restriction (minutes from midnight).

integer

Minimum booking length (minutes).

integer

Maximum booking length (minutes).

boolean

Only apply within the resource’s available times.

integer

Fixed cost booking length threshold (minutes).

number

Fixed cost price applied once the threshold is reached.

integer[]

List of tariffs linked to this record.

integer[]

The added tariffs value for this extra service.

integer[]

The removed tariffs value for this extra service.

boolean

Only available for contacts.

boolean

Only available for members.

boolean

Price uses booking credits.

boolean

Price uses printing credits.

boolean

Apply charge to visitors.

number

Price factor for low demand periods.

number

Price factor for average demand periods.

number

Price factor for high demand periods.

number

Price factor for last-minute bookings.

integer

Last-minute period threshold (minutes before booking).

string

Date from which this price applies.

string

Date until which this price applies.

string

Comma-separated names of associated resource types.

integer[]

List of teams linked to this record.

integer[]

The added teams value for this extra service.

integer[]

The removed teams value for this extra service.

Children

object[]

The days and times this extra service price is available for booking. The year, month and day component of FromTime/ToTime is always 1976-01-01.

Show child attributes

integer

required

The day of week value for this extra service time slot.

string

required

Start time of the availability window. Only the time-of-day component is used; the date component is always 1976-01-01..

string

required

End time of the availability window. Only the time-of-day component is used; the date component is always 1976-01-01..

boolean

Whether the extra service is available for booking during this time slot. When false, the slot acts as an explicit block..

Code Examples

curl -X PUT \
  "https://spaces.nexudus.com/api/billing/extraservices" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "DisplayOrder": 0,
    "Price": 0,
    "ChargePeriod": 0,
    "CurrencyId": 0,
    "LastMinuteAdjustmentType": 0,
    "Id": 87654321,
    "TimeSlots": [
        {
            "DayOfWeek": 0,
            "FromTime": "2025-01-15T10:30:00Z",
            "ToTime": "2025-01-15T10:30:00Z",
            "Available": null
        }
    ]
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/extraservices',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: '',
      DisplayOrder: 0,
      Price: 0,
      ChargePeriod: 0,
      CurrencyId: 0,
      LastMinuteAdjustmentType: 0,
      Id: 87654321,
      TimeSlots: [object Object]
    })
  }
);

const data = await response.json();

import requests

response = requests.put(
    'https://spaces.nexudus.com/api/billing/extraservices',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'DisplayOrder': 0,
        'Price': 0,
        'ChargePeriod': 0,
        'CurrencyId': 0,
        'LastMinuteAdjustmentType': 0,
        'Id': 87654321,
        'TimeSlots': [object Object]
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the update.

object

Contains the Id of the updated record.

boolean

true if the extraservice was updated successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "ExtraService was successfully updated.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}

Delete ExtraServiceDelete an existing ExtraService record by its Id.

Update ExtraService

curl --request PUT \
  --url https://spaces.nexudus.com/api/billing/extraservices \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "BusinessId": 123,
  "Name": "<string>",
  "DisplayOrder": 123,
  "Price": 123,
  "ChargePeriod": 123,
  "CurrencyId": 123,
  "LastMinuteAdjustmentType": 123,
  "FromTime": 123,
  "ToTime": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/extraservices"

payload = {
    "Id": 123,
    "BusinessId": 123,
    "Name": "<string>",
    "DisplayOrder": 123,
    "Price": 123,
    "ChargePeriod": 123,
    "CurrencyId": 123,
    "LastMinuteAdjustmentType": 123,
    "FromTime": 123,
    "ToTime": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    BusinessId: 123,
    Name: '<string>',
    DisplayOrder: 123,
    Price: 123,
    ChargePeriod: 123,
    CurrencyId: 123,
    LastMinuteAdjustmentType: 123,
    FromTime: 123,
    ToTime: 123
  })
};

fetch('https://spaces.nexudus.com/api/billing/extraservices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Children

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400