DevelopersChanges data

update_bookable_type

API reference — one of six tools an AI assistant can call on an Avrosh account.

What it does

Change one bookable type: name, prices, capacity, description, amenities, or the deposit asked to confirm a booking. Send ONLY the fields the human asked to change. deposit_kind 'percent' takes deposit_value 0-100; 'flat' takes a whole-currency amount; 'none' clears it. For schedule and hours changes use set_bookable_type_schedule.

This is the exact text the model reads before deciding to call.

Parameters

business_idstringrequired

The id returned by list_businesses.

type_idstringrequired

From list_bookable_types.

namestringoptional

priceintegeroptional

Base rate.

price_maxintegeroptional

Top of the range.

sleepsintegeroptional

descriptionstringoptional

bed_configstringoptional

viewstringoptional

amenitiesarrayoptional

deposit_kindstringoptional

one of: none · flat · percent

deposit_valueintegeroptional

0-100 for percent; whole-currency amount for flat.

deposit_refundablestringoptional

one of: true · false

Request

curl -X POST https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_bookable_type","arguments":{"business_id":"926135ac-487d-4367-8bad-25397d0d4b87","type_id":"e63a…","price":550000}}}'

Response

The result arrives as an MCP content block; the JSON below is what the text field parses to.

{
  "type": {
    "id": "e63a…",
    "name": "Deluxe Garden",
    "baseRateIdr": 550000
  }
}

Authentication

Every request carries Authorization: Bearer avk_…. Create a key in the Avrosh dashboard under Docs; it is shown once, because only its hash is stored.

One key reaches every business on the account that made it, and no others. There are no scopes to configure and nothing to switch on — a connected assistant receives the whole toolset. What bounds it is whose account the key belongs to, which is enforced in the database rather than by a permission anybody sets.

curl https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY"