Skip to main content
PUT
/
services
/
{id}
Update a service
curl --request PUT \
  --url https://api.salesive.com/api/v1/services/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "price": 90,
  "available": false
}
'
{
  "status": 200,
  "success": true,
  "message": "Update a service",
  "data": {
    "_id": "66a3b1c4e1b3a40012ef2001",
    "name": "Deep Tissue Massage",
    "description": "60-minute full-body massage",
    "price": 90,
    "promoPrice": null,
    "images": [
      "https://cdn.salesive.com/sv/massage.jpg"
    ],
    "available": false,
    "listed": true,
    "addons": [],
    "shop": "66a1eee0e1b3a40012ab0001",
    "updatedAt": "2026-06-28T09:35:00.000Z"
  }
}
Updates a service in the store. Supplied fields overwrite the existing values. Requires the WRITE_INVENTORY scope.

Authorizations

Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Path Parameters

id
string
required

ObjectId of the service to update.

Body

application/json
name
string

Service name (max 100 chars).

price
number

Price (>= 0).

description
string

Service description.

promoPrice
number | null

Promotional price (>= 0); nullable.

images
string[]

Array of image URLs.

video
string | null

Video URL; nullable.

available
boolean

Whether the service is available to book.

listed
boolean

Whether the service is listed on the storefront.

addons
object[]

Add-ons array (replaces existing). Each: name (required), price (required), maxQuantity, image, available, description.

Response

Update a service — success.

status
integer
required
Example:

200

success
boolean
required
Example:

true

message
string
required
Example:

"Update a service"

data
object
required

A business service item.

Example:
{
  "_id": "66a3b1c4e1b3a40012ef2001",
  "name": "Deep Tissue Massage",
  "description": "60-minute full-body massage",
  "price": 90,
  "promoPrice": null,
  "images": ["https://cdn.salesive.com/sv/massage.jpg"],
  "available": false,
  "listed": true,
  "addons": [],
  "shop": "66a1eee0e1b3a40012ab0001",
  "updatedAt": "2026-06-28T09:35:00.000Z"
}