# 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

```bash
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

```bash
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](https://pirateskills.com/docs/mcp)

## JSON Schema

```json
{
  "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"
  ]
}
```

---
Source: https://pirateskills.com/docs/tools/move_booking · All docs: https://pirateskills.com/docs.md · Short overview: https://pirateskills.com/llms.txt