BookingProposalRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/busyboard-app/json-schema/busyboard-app-booking-proposal-request-schema.json",
  "title": "BookingProposalRequest",
  "description": "Exactly one of `shareToken` or `connectionId` must be provided.\n",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/busyboard-app-api-openapi.yml#/components/schemas/BookingProposalRequest",
  "type": "object",
  "required": [
    "startTime",
    "durationMinutes",
    "idempotencyKey"
  ],
  "properties": {
    "shareToken": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "The token segment from a share URL (`/a/{slug}/{token}`) — same trust as a human holding the link."
    },
    "connectionId": {
      "type": "string",
      "format": "uuid",
      "description": "One of the caller's own external connections (see `/people` `connections[].connectionId`)."
    },
    "startTime": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 with offset. Must align to 15 minutes, be at least 1 hour out, and within 28 days."
    },
    "durationMinutes": {
      "type": "integer",
      "minimum": 15,
      "maximum": 120
    },
    "note": {
      "type": "string",
      "maxLength": 500
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128,
      "description": "Required. Caller-generated key scoping a retry-safe request. A\nreplayed call with the same key returns the original outcome\nwith the `X-Idempotency-Replayed: true` response header instead\nof creating a duplicate proposal.\n"
    }
  }
}