DevelopersChanges data

set_appointment_end

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

What it does

Move a running appointment's expected end time, taking the occupied window with it so later slot offers stay truthful. Appointments only, and only while confirmed or checked in. Give the FULL new end time (get_booking returns the current one as endAt) - not a number of minutes: a nudge like '+15 minutes' repeated after a timeout becomes half an hour and drags the occupied window twice, whereas repeating an absolute time simply lands on the same answer. The move must be within four hours of the current end and can never fall closer than five minutes after the start. It does not move the start - rebook for that - and does not change the price.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

booking_idstringrequired

From list_bookings.

new_end_timestringrequired

The full new end instant, ISO 8601 with an offset, e.g. 2026-08-20T11:30:00+08:00.

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":"set_appointment_end","arguments":{"business_id":"926135ac-487d-4367-8bad-25397d0d4b87","booking_id":"b901…","new_end_time":"2026-08-20T11:30:00+08:00"}}}'

Response

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

{
  "booking": {
    "id": "b901…",
    "endAt": "2026-08-20T03:30:00.000Z"
  },
  "movedMinutes": 15
}

Connecting

Paste the URL into your assistant and log in. Avrosh implements OAuth 2.1, so an MCP client discovers the authorisation server, registers itself, and opens a browser asking you to sign in here. That is the whole setup: nothing to copy, no key to keep, and nothing to rotate later.

https://us.avrosh.com/mcp

For something with no browser to log in with — a cron job, a script, an automation platform — there is a second door: a bearer key made in the dashboard under Docs, shown once because only its hash is stored, and revocable at any time.

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

Either way the boundary is the same one: an assistant reaches every business on the account it signed in to, and no others. There are no scopes to configure and nothing to switch on — what bounds it is whose account it is, enforced in the database rather than by a permission anybody sets.