DevelopersChanges data

update_business

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

What it does

Change a business's settings: its name, default language, timezone, what the AI handles on the phone (call_types), or what it says about being an AI when a caller asks (ai_disclosure). Read get_business first and send ONLY the fields the human asked to change - omitted fields are left alone. ai_disclosure: 'if_asked' answers honestly when raised, 'upfront' says it in the opening line, 'never' does not volunteer it. None of the three permits claiming to be human; that is not configurable.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

namestringoptional

languagestringoptional

Default language code, e.g. 'id'.

timezonestringoptional

IANA timezone.

call_typesarrayoptional

Any of: bookings, orders, jobs. Empty array = questions only.

ai_disclosurestringoptional

one of: if_asked · upfront · never

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_business","arguments":{"business_id":"926135ac-…","ai_disclosure":"upfront"}}}'

Response

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

{
  "business": {
    "id": "926135ac-…",
    "name": "Northgate Barbers",
    "ai_disclosure": "upfront"
  },
  "changed": 1
}

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"