Calendar

Move a meeting

calendar_move · Changes data · Markdown

Moves a booking to another free time and sends the attendee an updated invite.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

An example

Rachel Kim can't make Saturday after all. Move her fitting to the Saturday after, same time, and let her know.

Your agent callscalendar_move$0.01 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "booking": "K7QM2XWD4P",
  "start": "2026-10-31T11:30:00-07:00"
}
What comes back
{
  "booking": {
    "booking_id": "98038426-ed50-446f-8e48-09abbb514223",
    "reference": "K7QM2XWD4P",
    "status": "scheduled",
    "meeting_type": "bike-fitting",
    "title": "Bike fitting",
    "start": "2026-10-31T18:30:00+00:00",
    "end": "2026-10-31T19:15:00+00:00",
    "attendee_local_time": "Saturday, October 31, 2026 at 11:30 (America/Los Angeles)",
    "attendee": {
      "name": "Rachel Kim",
      "email": "rachel.kim@example.com",
      "phone": null,
      "timezone": "America/Los_Angeles"
    },
    "hosts": [],
    "guests": [],
    "answers": {},
    "location": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214",
    "booked_via": "bot",
    "manage_url": "https://cncto.co/booking/98038426-ed50-446f-8e48-09abbb514223?t=Ijk4MDM4NDI2LWVkNTAtNDQ2Zi04ZTQ4LTA5YWJiYjUxNDIyMyI:1xJYro:iArEwUHLy-HYxham9zo6y6kzFaBBLDVg4t0nxgsvIwE",
    "confirmation_call": null,
    "cancel_reason": null
  }
}

Use it when

The attendee or the business asks for another time.

What it does

Move a booking to another free time. The attendee and the guests get an updated invite by email. A round-robin meeting keeps its host when they are free then, else goes to the host its rules pick.

What comes back

The booking at its new time, in the same shape calendar_book returns. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
bookingRequiredstringIts reference or booking_id.
startRequiredstring (date-time)
notifybooleanDefault: true.

The call

Over MCP, call calendar_move on https://api.conecto.chat/mcp/calendar. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/calendar_move \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking":"K7QM2XWD4P","start":"2026-10-31T11:30:00-07:00"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No booking has that reference or booking_id.Find the booking with calendar_list_bookings and pass its reference.
time_taken409That time is not free: taken, outside the hours, too soon or too far ahead.Pick a start from calendar_find_times; the message lists free times nearby.
invalid_input400A time is not ISO 8601 with its offset, or a time zone is unknown.Send times like 2026-10-24T11:00:00-07:00 and zones like America/Los_Angeles.
not_movable409The booking was cancelled, or the meeting has already started.Book a new time with calendar_book instead.
sending_paused403Email from the business is paused, so the attendee cannot be emailed.Call again with notify: false, and ask the owner to contact Conecto about the pause.
suppressed422The attendee's address bounced, complained or unsubscribed before.Call again with notify: false, or use another address for them.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md