Update a company service

PUT

/api/v1/services/{uuid}

Last modified:2026-03-01 19:09:47

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://connect.dispatchable.com/catalog/api/v1/services/2e7b6d14-4c5c-46d2-a0bd-0cbf0e79a1a2' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Ductwork Repair (Updated)",
    "description": "Repair, reseal, and test airflow.",
    "default_unit_cost": 70,
    "default_unit_price": 135,
    "unit_label": "hour",
    "audiences": [
        "hvac",
        "home_services"
    ],
    "sort_order": 55,
    "is_active": true
}'

Response Example

200 - Example 1

{
    "uuid": "5c096d93-d5b6-488e-828b-a54f4605deec",
    "source": "company_db",
    "key": "free_assessment",
    "name": "Free Assessment",
    "description": "Our experts will come to assess your needs and discuss solutions",
    "category": "General",
    "audiences": [
        "hvac",
        "home_services",
        "shipper"
    ],
    "default_quantity": 1,
    "default_unit_cost": 0,
    "default_unit_price": 0,
    "unit_label": "visit",
    "sort_order": 10,
    "is_active": true,
    "is_system": true
}

Modified at 2026-03-01 19:09:47

Get a service by UUID

Delete a company service