Tool reference move_booking

move_booking

Move one of the signed-in person's own upcoming bookings (the free intro call or an hour with Ben, by its id from my_bookings, where canMove is true) to another open time of the same kind: for an hour with Ben a start from openHours, for the free intro call a start from introCall.moveTimes. Pass the start exactly as listed, and name the new time by its label, never by a weekday you work out. Nothing is charged: an hour keeps its diamond, the call stays free, and the calendar sends the updated invite. The answer's booking has the new label. Refused, with a reason, for a booking that is not theirs, already cancelled, begun, still waiting for the calendar, or a time that is not open.

Needs sign-in · 1 gold
Changes something – ask first

Input

Field	Type	Required	Notes
`bookingId`	`string (uuid)`	Yes	The id of one of the person's own upcoming bookings, exactly as my_bookings lists it.
`start`	`string (date-time)`	Yes	The new start, exactly as my_bookings lists it for that kind of booking: openHours for an hour with Ben, introCall.moveTimes for the free intro call, e.g. "2026-09-18T11:30:00.000+02:00".
`timeZone`	`string`	No	The person's time zone, e.g. "Europe/Berlin". Defaults to the booking's own. · at most 64 characters

Over HTTP

curl -X POST https://pirateskills.com/api/public/agent/tools/move_booking \
  -H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "bookingId": "<bookingId>", "start": "<start>" }'

From the CLI

pirateskills run move_booking --json '{ "bookingId": "<bookingId>", "start": "<start>" }'   # asks y/N first

Over MCP

Call move_booking on https://pirateskills.com/mcp. The tool is marked as one that changes something, so a well-behaved client asks the person first. Connect over MCP

JSON Schema

{
  "type": "object",
  "properties": {
    "bookingId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The id of one of the person's own upcoming bookings, exactly as my_bookings lists it."
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "The new start, exactly as my_bookings lists it for that kind of booking: openHours for an hour with Ben, introCall.moveTimes for the free intro call, e.g. \"2026-09-18T11:30:00.000+02:00\"."
    },
    "timeZone": {
      "description": "The person's time zone, e.g. \"Europe/Berlin\". Defaults to the booking's own.",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "bookingId",
    "start"
  ]
}

Use this page

Open in Claude Open in ChatGPT View as Markdown