@medalsocial/sdk 1.8.0 → 1.10.0

package/openapi/medal-social.openapi.yaml

@@ -732,6 +732,160 @@ paths:
                 $ref: "#/components/schemas/ApiResponse_BookingScheduleDayArray"
         default:
           $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/persons:
+    get:
+      tags: [Bookings]
+      operationId: listContactPersons
+      summary: List a contact's persons
+      description: >-
+        Persons a contact books for — a child, a pet, an employee. No login of
+        their own. Active-only unless `include_inactive` is set.
+      parameters:
+        - name: contact_id
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: include_inactive
+          in: query
+          schema:
+            type: boolean
+      responses:
+        "200":
+          description: Contact persons.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_ContactPersonArray"
+        default:
+          $ref: "#/components/responses/ApiError"
+    post:
+      tags: [Bookings]
+      operationId: createContactPerson
+      summary: Add a person under a contact
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateContactPersonInput"
+      responses:
+        "201":
+          description: Created person.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_ContactPerson"
+        default:
+          $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/relations:
+    get:
+      tags: [Bookings]
+      operationId: listContactRelations
+      summary: List a contact's relations
+      description: Directional relations a contact holds, split into outgoing and incoming.
+      parameters:
+        - name: contact_id
+          in: query
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Outgoing and incoming relations.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_ContactRelations"
+        default:
+          $ref: "#/components/responses/ApiError"
+    post:
+      tags: [Bookings]
+      operationId: createContactRelation
+      summary: Create a relation from one contact to another
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateContactRelationInput"
+      responses:
+        "201":
+          description: Created relation id.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_CreateContactRelationResult"
+        default:
+          $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/events:
+    get:
+      tags: [Bookings]
+      operationId: listBookingEvents
+      summary: List arrangementer in a date range
+      parameters:
+        - name: from
+          in: query
+          required: true
+          description: Start of the window, `yyyy-mm-dd`, inclusive.
+          schema:
+            type: string
+            format: date
+        - name: to
+          in: query
+          required: true
+          description: End of the window, `yyyy-mm-dd`, inclusive.
+          schema:
+            type: string
+            format: date
+        - name: status
+          in: query
+          schema:
+            $ref: "#/components/schemas/BookingEventStatus"
+      responses:
+        "200":
+          description: Arrangementer in the window.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingEventArray"
+        default:
+          $ref: "#/components/responses/ApiError"
+    post:
+      tags: [Bookings]
+      operationId: createBookingEvent
+      summary: Create an arrangement from a template
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateBookingEventInput"
+      responses:
+        "201":
+          description: Created arrangement.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingEvent"
+        default:
+          $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/events/{id}:
+    parameters:
+      - $ref: "#/components/parameters/Id"
+    get:
+      tags: [Bookings]
+      operationId: getBookingEvent
+      summary: Get an arrangement
+      responses:
+        "200":
+          description: Arrangement.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingEvent"
+        default:
+          $ref: "#/components/responses/ApiError"
   /api/v1/bookings/{id}:
     parameters:
       - $ref: "#/components/parameters/Id"
@@ -834,6 +988,98 @@ paths:
                 $ref: "#/components/schemas/ApiResponse_BookingActionResult"
         default:
           $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/{id}/payment:
+    parameters:
+      - $ref: "#/components/parameters/Id"
+    post:
+      tags: [Bookings]
+      operationId: startBookingPayment
+      summary: Start a Vipps payment for a booking
+      description: >-
+        Reserves (or charges) the booking's amount and returns the wallet
+        redirect URL. The customer must have accepted your terms before this
+        call — `terms_accepted` must be literally `true`, and a body omitting
+        it is a 400. One live payment per booking: a second while one is
+        outstanding answers 409, as does a booking that is not payable or a
+        refusal from Vipps. A `return_url` this workspace's own sites do not
+        vouch for answers 422, not 400 — the URL parses, it is just not yours.
+        403 when the payments switch or the bookings module is off.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/StartBookingPaymentInput"
+      responses:
+        "200":
+          description: >-
+            The reference and the SHOW-ONCE redirect URL. The URL is never
+            returned again — the payment behind it expires after ten minutes,
+            so a cached one leads into a payment that no longer exists.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingPaymentStart"
+        default:
+          $ref: "#/components/responses/ApiError"
+    get:
+      tags: [Bookings]
+      operationId: getBookingPayment
+      summary: Read the newest payment attempt on a booking
+      description: >-
+        Returns the newest attempt only. A booking with no payment yet, an
+        unknown booking id and another workspace's booking all answer 404
+        alike, so this is not an existence oracle.
+      responses:
+        "200":
+          description: The payment. `redirect_url` is deliberately absent here.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingPayment"
+        default:
+          $ref: "#/components/responses/ApiError"
+  /api/v1/bookings/manage/{token}/payment:
+    parameters:
+      - $ref: "#/components/parameters/ManageToken"
+    post:
+      tags: [Bookings]
+      operationId: startManageBookingPayment
+      summary: Start a payment on the customer's behalf
+      description: >-
+        The manage-token twin of `startBookingPayment` — same body, same
+        responses; only the credential that authorizes it differs.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/StartBookingPaymentInput"
+      responses:
+        "200":
+          description: The reference and the show-once redirect URL.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingPaymentStart"
+        default:
+          $ref: "#/components/responses/ApiError"
+    get:
+      tags: [Bookings]
+      operationId: getManageBookingPayment
+      summary: Read the payment on the customer's own booking
+      description: >-
+        An unknown token, another workspace's token and a booking with no
+        payment yet all answer 404 alike.
+      responses:
+        "200":
+          description: The payment. `redirect_url` is deliberately absent here.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponse_BookingPayment"
+        default:
+          $ref: "#/components/responses/ApiError"
   /api/v1/bookings/manage/{token}:
     parameters:
       - $ref: "#/components/parameters/ManageToken"
@@ -1051,9 +1297,13 @@ paths:
       summary: Export everything held about the signed-in contact
       description: >-
         A synchronous GDPR Art. 15 export of the contact's profile, family,
-        consents and bookings, as one JSON document. Read-only, so not
-        idempotency-keyed. Errors: `401 PORTAL_SESSION_REQUIRED`,
-        `401 PORTAL_SESSION_INVALID`, `403 FORBIDDEN`, `429 RATE_LIMITED`.
+        consents and bookings, as one JSON document. Unlike `GET
+        /api/v1/portal/me`, `contact.persons` here includes inactive persons
+        so the export is a complete dump. `relations` lists every relation
+        the contact is a party to, exposing only the counterpart's display
+        name. Read-only, so not idempotency-keyed. Errors: `401
+        PORTAL_SESSION_REQUIRED`, `401 PORTAL_SESSION_INVALID`, `403
+        FORBIDDEN`, `429 RATE_LIMITED`.
       responses:
         "200":
           description: The export.
@@ -2627,6 +2877,19 @@ components:
     BookingPaymentStatus:
       type: string
       enum: [none, reserved, captured, refunded]
+    BookingPaymentMode:
+      description: >-
+        What a booking must have paid before the business honours it: nothing,
+        a reservation captured later, or the full amount up front.
+      type: string
+      enum: [none, reserve, prepay]
+    BookingPaymentState:
+      description: >-
+        The state of one payment attempt, in Medal's vocabulary rather than the
+        wallet's — a Vipps payment stays AUTHORIZED after a capture, so read
+        the øre aggregates to learn what actually moved.
+      type: string
+      enum: [created, authorized, captured, cancelled, refunded, failed, expired]
     BookingCreatedVia:
       type: string
       enum: [web, dashboard, walk_in, api]
@@ -2644,12 +2907,16 @@ components:
         - end_ts
         - booked_for_name
         - booked_for_birth_year
+        - booked_for_person_id
+        - event_id
+        - event_order
         - party_sequence_id
         - status
         - cancelled_by
         - cancel_reason
         - rescheduled_from_id
         - payment_status
+        - payment_mode
         - amount_ore
         - notes
         - internal_notes
@@ -2676,6 +2943,15 @@ components:
         booked_for_birth_year:
           description: A birth year, not a birthdate — the age bracket is all that is stored.
           type: [integer, "null"]
+        booked_for_person_id:
+          description: The ContactPerson this booking was made for, if any.
+          type: [string, "null"]
+        event_id:
+          description: The BookingEvent this booking is a registration for, if any.
+          type: [string, "null"]
+        event_order:
+          description: Position of this booking within its event's registrations, if any.
+          type: [integer, "null"]
         party_sequence_id:
           description: Shared by every booking created in the same party request.
           type: [string, "null"]
@@ -2692,6 +2968,12 @@ components:
           type: [string, "null"]
         payment_status:
           $ref: "#/components/schemas/BookingPaymentStatus"
+        payment_mode:
+          description: >-
+            What this booking required when it was made — frozen at creation.
+            `payment_status: none` cannot tell "owes nothing" from "has not
+            paid yet"; this can.
+          $ref: "#/components/schemas/BookingPaymentMode"
         amount_ore:
           description: Price in integer øre. Never a float and never kroner.
           type: [integer, "null"]
@@ -2725,6 +3007,7 @@ components:
         - weekend_surcharge_pct
         - resource_requirements
         - bookable_online
+        - payment
         - max_per_booking
         - color
         - sort_order
@@ -2758,6 +3041,13 @@ components:
             type: string
         bookable_online:
           type: boolean
+        payment:
+          description: >-
+            Per-service payment requirement. `null` means no override — the
+            workspace rule decides.
+          oneOf:
+            - $ref: "#/components/schemas/BookingPaymentMode"
+            - type: "null"
         max_per_booking:
           type: [integer, "null"]
         color:
@@ -2880,6 +3170,9 @@ components:
           type: integer
           minimum: 1900
           maximum: 2200
+        booked_for_person_id:
+          description: Book this line on behalf of a ContactPerson rather than the contact.
+          type: string
     CreateBookingInput:
       type: object
       required: [items, contact]
@@ -2975,6 +3268,7 @@ components:
         - party_sequence_id
         - amount_ore
         - payment_status
+        - payment_mode
         - time_zone
         - cancel_window_hours
         - reschedule_window_hours
@@ -3022,6 +3316,11 @@ components:
           oneOf:
             - $ref: "#/components/schemas/BookingPaymentStatus"
             - type: "null"
+        payment_mode:
+          description: >-
+            What this booking requires — what a manage page checks before
+            offering «Betal nå».
+          $ref: "#/components/schemas/BookingPaymentMode"
         time_zone:
           description: IANA zone the booking's local times should be rendered in.
           type: [string, "null"]
@@ -3086,6 +3385,131 @@ components:
           $ref: "#/components/schemas/BookingTimestampInput"
         new_resource_id:
           type: string
+    StartBookingPaymentInput:
+      description: >-
+        Body for `startBookingPayment` and `startManageBookingPayment`.
+      type: object
+      required: [return_url, terms_accepted]
+      properties:
+        return_url:
+          description: >-
+            Where the wallet returns the customer. Must be a URL one of this
+            workspace's own sites vouches for; anything else answers 422.
+          type: string
+          minLength: 1
+          maxLength: 2048
+        terms_accepted:
+          description: >-
+            Must be literally `true`. The customer has to actively accept the
+            merchant's terms BEFORE a payment is initiated, so omitting it or
+            sending `false` is a 400 and leaves no payment behind.
+          const: true
+          type: boolean
+        terms_version:
+          description: The caller's own version label for the terms that were accepted.
+          type: string
+          minLength: 1
+          maxLength: 64
+        terms_text:
+          description: The exact text that was accepted, stored with the consent record.
+          type: string
+          maxLength: 2000
+    BookingPaymentStart:
+      description: >-
+        The result of starting a payment. `redirect_url` is handed over here
+        and nowhere else.
+      type: object
+      required: [reference, redirect_url, state]
+      properties:
+        reference:
+          description: The wallet reference for this attempt.
+          type: string
+        redirect_url:
+          description: >-
+            Send the customer here UNCHANGED — hand it to the Vipps Widget SDK.
+            SHOW-ONCE: it is not returned by `getBookingPayment`, and the
+            payment behind it expires after ten minutes.
+          type: string
+        state:
+          $ref: "#/components/schemas/BookingPaymentState"
+    BookingPayment:
+      description: >-
+        One payment attempt on a booking. Money is integer øre, and the four
+        aggregates are numbers rather than nulls — "nothing captured" is `0`.
+        `redirect_url`, the wallet's own refusal text and the trace id are
+        deliberately absent.
+      type: object
+      required:
+        - reference
+        - provider
+        - state
+        - mode
+        - attempt
+        - amount_ore
+        - authorized_ore
+        - captured_ore
+        - refunded_ore
+        - cancelled_ore
+        - currency
+        - capture_guaranteed_until
+        - terms_version
+        - terms_accepted_at
+        - failure_code
+        - created_at
+        - updated_at
+      properties:
+        reference:
+          type: string
+        provider:
+          const: vipps
+          type: string
+        state:
+          $ref: "#/components/schemas/BookingPaymentState"
+        mode:
+          description: Never `none` — a payment exists only where one was required.
+          type: string
+          enum: [reserve, prepay]
+        attempt:
+          description: 1 for the first attempt on this booking, incrementing per retry.
+          type: integer
+        amount_ore:
+          description: The amount this attempt is for, in integer øre.
+          type: integer
+        authorized_ore:
+          type: integer
+        captured_ore:
+          type: integer
+        refunded_ore:
+          type: integer
+        cancelled_ore:
+          type: integer
+        currency:
+          const: NOK
+          type: string
+        capture_guaranteed_until:
+          description: >-
+            The last moment a capture is GUARANTEED to succeed. The card behind
+            the wallet may release the reservation afterwards, so a capture
+            past it can fail even though the payment still looks authorized.
+            Null until the customer has approved.
+          type: [string, "null"]
+          format: date-time
+        terms_version:
+          type: [string, "null"]
+        terms_accepted_at:
+          type: [string, "null"]
+          format: date-time
+        failure_code:
+          description: >-
+            The wallet's numeric error code from the last failed operation —
+            what a caller branches on.
+          type: [string, "null"]
+        created_at:
+          type: [string, "null"]
+          format: date-time
+        updated_at:
+          type: [string, "null"]
+          format: date-time
     BookingsPagination:
       description: >-
         Pagination for a bookings page. `truncated` is the extra statement:
@@ -3808,6 +4232,10 @@ components:
       $ref: "#/components/schemas/Envelope_BookingActionResult"
     ApiResponse_BookingRescheduleResult:
       $ref: "#/components/schemas/Envelope_BookingRescheduleResult"
+    ApiResponse_BookingPaymentStart:
+      $ref: "#/components/schemas/Envelope_BookingPaymentStart"
+    ApiResponse_BookingPayment:
+      $ref: "#/components/schemas/Envelope_BookingPayment"
     ApiResponse_ManageSummary:
       $ref: "#/components/schemas/Envelope_ManageSummary"
     ApiResponse_PortalLoginStartResult:
@@ -4145,6 +4573,18 @@ components:
       properties:
         data:
           $ref: "#/components/schemas/BookingRescheduleResult"
+    Envelope_BookingPaymentStart:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/BookingPaymentStart"
+    Envelope_BookingPayment:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/BookingPayment"
     Envelope_ManageSummary:
       type: object
       required: [data]
@@ -4213,6 +4653,41 @@ components:
           type: string
         birth_year:
           type: integer
+    PortalPerson:
+      description: >-
+        A person the contact books for — a child, a pet — with no login of
+        its own.
+      type: object
+      required:
+        [person_id, name, birth_year, relation_type, relation_label, notes, active]
+      properties:
+        person_id:
+          type: string
+        name:
+          type: string
+        birth_year:
+          type: [integer, "null"]
+        relation_type:
+          $ref: "#/components/schemas/RelationType"
+        relation_label:
+          type: [string, "null"]
+        notes:
+          type: [string, "null"]
+        active:
+          type: boolean
+          description: >-
+            False for a person the customer removed or that was promoted to
+            its own contact; `me` returns active persons only, the export
+            returns all.
+    PortalLabels:
+      description: The workspace's own words for the person concept, e.g. `"Barn"`.
+      type: object
+      required: [person, persons]
+      properties:
+        person:
+          type: string
+        persons:
+          type: string
     PortalProfile:
       type: object
       required:
@@ -4222,6 +4697,8 @@ components:
         - last_name
         - phone
         - family
+        - persons
+        - labels
         - marketing_consent
         - created_at
       properties:
@@ -4239,6 +4716,12 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/PortalFamilyMember"
+        persons:
+          type: array
+          items:
+            $ref: "#/components/schemas/PortalPerson"
+        labels:
+          $ref: "#/components/schemas/PortalLabels"
         marketing_consent:
           type: boolean
         created_at:
@@ -4340,10 +4823,35 @@ components:
           description: Unix timestamp in milliseconds, or `null`.
         source:
           type: string
+    PortalExportRelation:
+      description: A relation the exporting contact is a party to; only the counterpart's display name is exposed.
+      type: object
+      required:
+        - direction
+        - type
+        - custom_label
+        - since
+        - note
+        - counterpart_name
+      properties:
+        direction:
+          type: string
+          enum: [outgoing, incoming]
+        type:
+          $ref: "#/components/schemas/RelationType"
+        custom_label:
+          type: [string, "null"]
+        since:
+          type: [integer, "null"]
+          description: Unix timestamp in milliseconds.
+        note:
+          type: [string, "null"]
+        counterpart_name:
+          type: string
     PortalExport:
       description: Everything the workspace holds about the signed-in contact (GDPR Art. 15).
       type: object
-      required: [exported_at, contact, family, consents, bookings]
+      required: [exported_at, contact, family, consents, bookings, relations]
       properties:
         exported_at:
           type: integer
@@ -4362,6 +4870,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/PortalBooking"
+        relations:
+          type: array
+          items:
+            $ref: "#/components/schemas/PortalExportRelation"
     Envelope_PortalLoginStartResult:
       type: object
       required: [data]
@@ -4743,3 +5255,293 @@ components:
       properties:
         data:
           $ref: "#/components/schemas/ChannelConnectionDisconnectResult"
+    RelationType:
+      description: How a person or a relation relates to a contact.
+      type: string
+      enum: [guardian, owner, employer, caregiver, partner, custom]
+    ContactPerson:
+      description: >-
+        A person a contact books for — a child, a pet, an employee. No login
+        of their own.
+      type: object
+      required:
+        - person_id
+        - contact_id
+        - name
+        - birth_year
+        - relation_type
+        - relation_label
+        - notes
+        - active
+        - promoted_to_contact_id
+        - created_at
+        - updated_at
+      properties:
+        person_id:
+          type: string
+        contact_id:
+          type: string
+        name:
+          type: string
+        birth_year:
+          type: [integer, "null"]
+        relation_type:
+          $ref: "#/components/schemas/RelationType"
+        relation_label:
+          type: [string, "null"]
+        notes:
+          type: [string, "null"]
+        active:
+          type: boolean
+        promoted_to_contact_id:
+          type: [string, "null"]
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    CreateContactPersonInput:
+      type: object
+      required: [contact_id, name, relation_type]
+      properties:
+        contact_id:
+          type: string
+        name:
+          type: string
+        birth_year:
+          type: integer
+        relation_type:
+          $ref: "#/components/schemas/RelationType"
+        relation_label:
+          type: string
+        notes:
+          type: string
+    ContactRelation:
+      description: One directional relation between two contacts.
+      type: object
+      required:
+        - relation_id
+        - from_contact_id
+        - to_contact_id
+        - type
+        - custom_label
+        - since
+        - note
+        - counterpart_name
+        - created_at
+      properties:
+        relation_id:
+          type: string
+        from_contact_id:
+          type: string
+        to_contact_id:
+          type: string
+        type:
+          $ref: "#/components/schemas/RelationType"
+        custom_label:
+          type: [string, "null"]
+        since:
+          type: [integer, "null"]
+          description: Unix timestamp in milliseconds.
+        note:
+          type: [string, "null"]
+        counterpart_name:
+          type: string
+          description: Empty string when the counterpart contact no longer exists.
+        created_at:
+          type: string
+          format: date-time
+    ContactRelations:
+      description: Relations a contact holds, split by direction.
+      type: object
+      required: [outgoing, incoming]
+      properties:
+        outgoing:
+          type: array
+          items:
+            $ref: "#/components/schemas/ContactRelation"
+        incoming:
+          type: array
+          items:
+            $ref: "#/components/schemas/ContactRelation"
+    CreateContactRelationInput:
+      type: object
+      required: [from_contact_id, to_contact_id, type]
+      properties:
+        from_contact_id:
+          type: string
+        to_contact_id:
+          type: string
+        type:
+          $ref: "#/components/schemas/RelationType"
+        custom_label:
+          type: string
+        since:
+          type: integer
+          description: Unix timestamp in milliseconds.
+        note:
+          type: string
+    CreateContactRelationResult:
+      type: object
+      required: [relation_id]
+      properties:
+        relation_id:
+          type: string
+    BookingEventStatus:
+      type: string
+      enum: [draft, open, closed, completed, cancelled]
+    BookingEventTemplateKey:
+      type: string
+      enum: [kindergarten_visit, company_day, class, open_day, custom]
+    BookingEvent:
+      description: An arrangement — a scheduled group session bookings register against.
+      type: object
+      required:
+        - event_id
+        - template_id
+        - host_id
+        - date
+        - window_start_minute
+        - window_end_minute
+        - place
+        - capacity
+        - minimum
+        - registered_count
+        - service_ids
+        - resource_ids
+        - price_override_ore
+        - status
+        - registration_closes_at
+        - slug
+        - created_at
+        - updated_at
+      properties:
+        event_id:
+          type: string
+        template_id:
+          type: string
+        host_id:
+          type: [string, "null"]
+        date:
+          description: yyyy-mm-dd in the workspace time zone.
+          type: string
+          format: date
+        window_start_minute:
+          type: integer
+        window_end_minute:
+          type: integer
+        place:
+          type: string
+          enum: [at_host, in_house]
+        capacity:
+          type: integer
+        minimum:
+          type: integer
+        registered_count:
+          type: integer
+        service_ids:
+          type: array
+          items:
+            type: string
+        resource_ids:
+          type: array
+          items:
+            type: string
+        price_override_ore:
+          type: [integer, "null"]
+        status:
+          $ref: "#/components/schemas/BookingEventStatus"
+        registration_closes_at:
+          type: string
+          format: date-time
+        slug:
+          type: string
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    CreateBookingEventInput:
+      type: object
+      required: [template_key, date, window_start_minute, place, service_ids, resource_ids]
+      properties:
+        template_key:
+          $ref: "#/components/schemas/BookingEventTemplateKey"
+        host_id:
+          type: string
+        date:
+          type: string
+          format: date
+        window_start_minute:
+          type: integer
+        window_end_minute:
+          type: integer
+        place:
+          type: string
+          enum: [at_host, in_house]
+        capacity:
+          type: integer
+        minimum:
+          type: integer
+        service_ids:
+          type: array
+          items:
+            type: string
+        resource_ids:
+          type: array
+          items:
+            type: string
+    ApiResponse_ContactPersonArray:
+      $ref: "#/components/schemas/Envelope_ContactPersonArray"
+    ApiResponse_ContactPerson:
+      $ref: "#/components/schemas/Envelope_ContactPerson"
+    ApiResponse_ContactRelations:
+      $ref: "#/components/schemas/Envelope_ContactRelations"
+    ApiResponse_CreateContactRelationResult:
+      $ref: "#/components/schemas/Envelope_CreateContactRelationResult"
+    ApiResponse_BookingEventArray:
+      $ref: "#/components/schemas/Envelope_BookingEventArray"
+    ApiResponse_BookingEvent:
+      $ref: "#/components/schemas/Envelope_BookingEvent"
+    Envelope_ContactPersonArray:
+      type: object
+      required: [data]
+      properties:
+        data:
+          type: array
+          items:
+            $ref: "#/components/schemas/ContactPerson"
+    Envelope_ContactPerson:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/ContactPerson"
+    Envelope_ContactRelations:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/ContactRelations"
+    Envelope_CreateContactRelationResult:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/CreateContactRelationResult"
+    Envelope_BookingEventArray:
+      type: object
+      required: [data]
+      properties:
+        data:
+          type: array
+          items:
+            $ref: "#/components/schemas/BookingEvent"
+    Envelope_BookingEvent:
+      type: object
+      required: [data]
+      properties:
+        data:
+          $ref: "#/components/schemas/BookingEvent"