title: Meal Request
x-tags:
  - Catalog
type: object
description: On edit, omitted top-level properties retain their existing values.
properties:
  name:
    type: string
    minLength: 1
    maxLength: 255
    example: Coffee and Cake Meal
  tags:
    allOf:
      - $ref: ./CatalogUuidList.yaml
    description: UUIDs of tags to associate with the meal.
  media_uuid:
    type:
      - string
      - 'null'
    format: uuid
    description: The UUID of an image in the merchant's media library. Supply `null` to remove existing media.
  media_background_colour:
    type:
      - string
      - 'null'
    pattern: '^#(?:[A-Fa-f0-9]{3}|[A-Fa-f0-9]{6})$'
    example: '#F0F0F0'
  pricing:
    type: object
    required:
      - base
    properties:
      base:
        allOf:
          - $ref: ./Money.yaml
          - type: object
            properties:
              amount:
                minimum: 0
                maximum: 4294967295
              currency:
                description: Must match the merchant's ISO 4217 currency code.
      take_away:
        oneOf:
          - type: 'null'
          - allOf:
              - $ref: ./Money.yaml
              - type: object
                properties:
                  amount:
                    minimum: 0
                    maximum: 4294967295
                  currency:
                    description: Must match the merchant's ISO 4217 currency code.
      dine_in:
        oneOf:
          - type: 'null'
          - allOf:
              - $ref: ./Money.yaml
              - type: object
                properties:
                  amount:
                    minimum: 0
                    maximum: 4294967295
                  currency:
                    description: Must match the merchant's ISO 4217 currency code.
      delivery:
        oneOf:
          - type: 'null'
          - allOf:
              - $ref: ./Money.yaml
              - type: object
                properties:
                  amount:
                    minimum: 0
                    maximum: 4294967295
                  currency:
                    description: Must match the merchant's ISO 4217 currency code.
      retail:
        oneOf:
          - type: 'null'
          - allOf:
              - $ref: ./Money.yaml
              - type: object
                properties:
                  amount:
                    minimum: 0
                    maximum: 4294967295
                  currency:
                    description: Must match the merchant's ISO 4217 currency code.
      membership:
        oneOf:
          - type: 'null'
          - allOf:
              - $ref: ./Money.yaml
              - type: object
                properties:
                  amount:
                    minimum: 0
                    maximum: 4294967295
                  currency:
                    description: Must match the merchant's ISO 4217 currency code.
  availability:
    $ref: ./AvailabilityRequest.yaml
  description:
    type:
      - string
      - 'null'
    minLength: 1
    maxLength: 255
  machine_readable_qr_code_data:
    type:
      - string
      - 'null'
    minLength: 1
    maxLength: 255
  modifier_groups:
    allOf:
      - $ref: ./CatalogUuidList.yaml
    description: UUIDs of modifier groups to associate with the meal.
  translations:
    type: object
    properties:
      name:
        $ref: ./Translation.yaml
      description:
        $ref: ./Translation.yaml
