Microsoft Graph Users.mailbox Settings API

openapi: 3.2.0
info:
  title: Microsoft Graph OData Service for namespace microsoft.graph…
  description: This OData service is located at https://graph.microsoft.com/v1.0
  version: v1.0
  x-ms-generated-by:
    toolName: Microsoft.OpenApi.OData
    toolVersion: 1.0.9.0
servers:
- url: https://graph.microsoft.com/v1.0
tags:
- name: users.mailboxSettings
  x-ms-docs-toc-type: page
paths:
  /users/{user-id}/mailboxSettings:
    parameters:
    - name: user-id
      in: path
      description: The unique identifier of user
      required: true
      schema:
        type: string
      x-ms-docs-key-type: user
    get:
      tags:
      - users.mailboxSettings
      summary: Microsoft Graph Get mailboxSettings property value
      description: Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.
      operationId: users.GetMailboxSettings
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    patch:
      tags:
      - users.mailboxSettings
      summary: Microsoft Graph Update property mailboxSettings value
      operationId: users.UpdateMailboxSettings
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
components:
  schemas:
    microsoft.graph.ODataErrors.InnerError:
      title: InnerError
      required:
      - '@odata.type'
      type: object
      properties:
        request-id:
          type:
          - string
          - 'null'
          description: Request Id as tracked internally by the service
        client-request-id:
          type:
          - string
          - 'null'
          description: Client request Id as sent by the client application.
        date:
          pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
          type:
          - string
          - 'null'
          description: Date when the error occured.
          format: date-time
        '@odata.type':
          type: string
    microsoft.graph.timeZoneBase:
      title: timeZoneBase
      required:
      - '@odata.type'
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The name of a time zone. It can be a standard time zone name such as 'Hawaii-Aleutian Standard Time', or 'Customized Time Zone' for a custom time zone.
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.customTimeZone': '#/components/schemas/microsoft.graph.customTimeZone'
    microsoft.graph.ODataErrors.ODataError:
      required:
      - error
      type: object
      properties:
        error:
          $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError'
    microsoft.graph.dateTimeTimeZone:
      title: dateTimeTimeZone
      required:
      - '@odata.type'
      type: object
      properties:
        dateTime:
          type: string
          description: A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).
        timeZone:
          type:
          - string
          - 'null'
          description: Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.
        '@odata.type':
          type: string
    microsoft.graph.automaticRepliesStatus:
      title: automaticRepliesStatus
      enum:
      - disabled
      - alwaysEnabled
      - scheduled
      type: string
    microsoft.graph.ODataErrors.MainError:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
        message:
          type: string
          x-ms-primary-error-message: true
        target:
          type:
          - string
          - 'null'
        details:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails'
        innerError:
          $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError'
    microsoft.graph.userPurpose:
      title: userPurpose
      enum:
      - user
      - linked
      - shared
      - room
      - equipment
      - others
      - unknownFutureValue
      type: string
    microsoft.graph.automaticRepliesSetting:
      title: automaticRepliesSetting
      required:
      - '@odata.type'
      type: object
      properties:
        externalAudience:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.externalAudienceScope'
          - type:
            - object
            - 'null'
          description: 'The set of audience external to the signed-in user''s organization who will receive the ExternalReplyMessage, if Status is AlwaysEnabled or Scheduled. The possible values are: none, contactsOnly, all.'
        externalReplyMessage:
          type:
          - string
          - 'null'
          description: The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled.
        internalReplyMessage:
          type:
          - string
          - 'null'
          description: The automatic reply to send to the audience internal to the signed-in user's organization, if Status is AlwaysEnabled or Scheduled.
        scheduledEndDateTime:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
          - type:
            - object
            - 'null'
          description: The date and time that automatic replies are set to end, if Status is set to Scheduled.
        scheduledStartDateTime:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
          - type:
            - object
            - 'null'
          description: The date and time that automatic replies are set to begin, if Status is set to Scheduled.
        status:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.automaticRepliesStatus'
          - type:
            - object
            - 'null'
          description: 'Configurations status for automatic replies. The possible values are: disabled, alwaysEnabled, scheduled.'
        '@odata.type':
          type: string
    microsoft.graph.localeInfo:
      title: localeInfo
      required:
      - '@odata.type'
      type: object
      properties:
        displayName:
          type:
          - string
          - 'null'
          description: A name representing the user's locale in natural language, for example, 'English (United States)'.
        locale:
          type:
          - string
          - 'null'
          description: A locale representation for the user, which includes the user's preferred language and country/region. For example, 'en-us'. The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2.
        '@odata.type':
          type: string
    microsoft.graph.externalAudienceScope:
      title: externalAudienceScope
      enum:
      - none
      - contactsOnly
      - all
      type: string
    microsoft.graph.delegateMeetingMessageDeliveryOptions:
      title: delegateMeetingMessageDeliveryOptions
      enum:
      - sendToDelegateAndInformationToPrincipal
      - sendToDelegateAndPrincipal
      - sendToDelegateOnly
      type: string
    microsoft.graph.dayOfWeek:
      title: dayOfWeek
      enum:
      - sunday
      - monday
      - tuesday
      - wednesday
      - thursday
      - friday
      - saturday
      type: string
    microsoft.graph.mailboxSettings:
      title: mailboxSettings
      required:
      - '@odata.type'
      type: object
      properties:
        archiveFolder:
          type:
          - string
          - 'null'
          description: Folder ID of an archive folder for the user.
        automaticRepliesSetting:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.automaticRepliesSetting'
          - type:
            - object
            - 'null'
          description: Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user.
        dateFormat:
          type:
          - string
          - 'null'
          description: The date format for the user's mailbox.
        delegateMeetingMessageDeliveryOptions:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.delegateMeetingMessageDeliveryOptions'
          - type:
            - object
            - 'null'
          description: 'If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. The possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly.'
        language:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.localeInfo'
          - type:
            - object
            - 'null'
          description: The locale information for the user, including the preferred language and country/region.
        timeFormat:
          type:
          - string
          - 'null'
          description: The time format for the user's mailbox.
        timeZone:
          type:
          - string
          - 'null'
          description: The default time zone for the user's mailbox.
        userPurpose:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.userPurpose'
          - type:
            - object
            - 'null'
          description: 'The purpose of the mailbox. Differentiates a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online. The possible values are: user, linked, shared, room, equipment, others, unknownFutureValue. Read-only.'
        workingHours:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.workingHours'
          - type:
            - object
            - 'null'
          description: The days of the week and hours in a specific time zone that the user works.
        '@odata.type':
          type: string
    microsoft.graph.workingHours:
      title: workingHours
      required:
      - '@odata.type'
      type: object
      properties:
        daysOfWeek:
          type: array
          items:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.dayOfWeek'
            - type:
              - object
              - 'null'
          description: The days of the week on which the user works.
        endTime:
          pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$
          type:
          - string
          - 'null'
          description: The time of the day that the user stops working.
          format: time
        startTime:
          pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$
          type:
          - string
          - 'null'
          description: The time of the day that the user starts working.
          format: time
        timeZone:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.timeZoneBase'
          - type:
            - object
            - 'null'
          description: The time zone to which the working hours apply.
        '@odata.type':
          type: string
    microsoft.graph.ODataErrors.ErrorDetails:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        target:
          type:
          - string
          - 'null'
  responses:
    error:
      description: error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError'