> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sakari.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reschedule a Meeting



## OpenAPI

````yaml externals-reference/generated.yaml put /v1/meetings/{meetingId}
openapi: 3.1.0
info:
  description: >
    For more information about Sakari, visit
    [https://sakari.io](https://sakari.io).
  version: 1.0.0
  title: Sakari
  termsOfService: https://sakari.io/terms-service.html
  contact:
    email: help@sakari.io
servers:
  - description: Sakari Externals API
    url: https://external.sakari.io
security: []
tags:
  - name: meetings
    description: Book, reschedule or cancel meetings
paths:
  /v1/meetings/{meetingId}:
    put:
      tags:
        - externals.meetings
      summary: Reschedule a Meeting
      operationId: externals.meetings.reschedule
      parameters:
        - $ref: '#/components/parameters/meetingId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MeetingRequest'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingResponse'
        4XX:
          $ref: '#/components/responses/4XX'
        5XX:
          $ref: '#/components/responses/5XX'
components:
  parameters:
    meetingId:
      name: meetingId
      in: path
      required: true
      description: The ID of the meeting
      schema:
        type: string
  schemas:
    MeetingRequest:
      type: object
      properties:
        start:
          type: string
          format: date-time
        duration:
          type: number
        attendees:
          type: array
          items:
            type: object
            properties:
              firstName:
                type: string
              lastName:
                type: string
              email:
                type: string
              mobile:
                $ref: '#/components/schemas/InternationalNumber'
        notes:
          type: string
      required:
        - start
        - duration
        - attendees
    MeetingResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          properties:
            data:
              $ref: '#/components/schemas/Meeting'
      required:
        - data
    InternationalNumber:
      type: object
      properties:
        country:
          type: string
        number:
          type: string
          example: 123-456-7890
        verified:
          type: string
          format: date-time
        valid:
          type: boolean
        lineType:
          type: string
          example: mobile
      required:
        - country
        - number
    BasicResponse:
      type: object
      properties:
        success:
          type: boolean
      required:
        - success
    Meeting:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
        notes:
          type: string
        status:
          type: string
          enum:
            - upcoming
            - confirmed
            - cancelled
        hosts:
          type: array
          items:
            allOf:
              - type: object
                properties:
                  id:
                    type: string
                    readOnly: true
                  email:
                    type: string
                    example: chris@sakari.io
                  firstName:
                    type: string
                    example: Chris
                  lastName:
                    type: string
                    example: Bloggs
                  mobile:
                    $ref: '#/components/schemas/InternationalNumber'
            required:
              - id
        attendees:
          type: array
          items: b6194df2-7397-48f4-bb41-3051a2f13504
        rescheduleLink:
          type: string
        cancelLink:
          type: string
      required:
        - id
        - name
        - start
        - end
    ErrorResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          properties:
            error:
              $ref: '#/components/schemas/Error'
      required:
        - error
    Error:
      type: object
      properties:
        code:
          type: string
          example: CONT-010
        description:
          type: string
          example: Contact has requested no further communication
      required:
        - code
        - description
  responses:
    4XX:
      description: invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    5XX:
      description: invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````