openapi.yaml

openapi: 3.1.0
info:
   title: ManageXR API
   description: API documentation for ManageXR
   version: 1.0.0
servers:
   - url: https://managexrapi.com
     description: ManageXR API Server

paths:
   # v1 Endpoints:
   ##################################################
   # Devices
   ##################################################
   /v1/devices/:
      get:
         summary: List devices
         description: Retrieve a list of devices
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
            - name: names
              in: query
              required: false
              schema:
                 type: string
              description: Query by device name. Allows partial matching. Separate multiple name parameters by comma.
            - name: serials
              in: query
              required: false
              schema:
                 type: string
              description: Query by device serial. Allows partial matching. Separate multiple serial parameters by comma.
            - name: configurations
              in: query
              required: false
              schema:
                 type: string
              description: Query by configuration unique identifier. Separate multiple configuration id parameters by comma.
            - name: tags
              in: query
              required: false
              schema:
                 type: string
              description: Query by tag unique identifier. Separate multiple tag id parameters by comma.
            - name: models
              in: query
              required: false
              schema:
                 type: string
              description: Query by model name. Separate multiple model parameters by comma.
            - name: manufacturers
              in: query
              required: false
              schema:
                 type: string
              description: Query by manufacturer name. Separate multiple manufacturer parameters by comma.
            - name: firmwareVersions
              in: query
              required: false
              schema:
                 type: string
              description: Query by firmware version. Separate multiple firmware version parameters by comma.
            - name: filters
              in: query
              required: false
              schema:
                 type: string
                 enum:
                    - online
                    - offline
                    - upToDate
                    - outOfDate
                    - updateError
                    - updating
                    - paused
                    - lowBattery
                    - activeToday
                    - activeWeek
                    - activeMonth
                    - activeOther
                    - factoryResetPending
                    - factoryReset
              description: Query by filter.
         responses:
            "200":
               description: A list of devices
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1Device"
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Not found error"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/devices/{id}:
      get:
         summary: Get device
         description: Retrieve a device by id (serial number)
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier (serial number) of the device
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A device object
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1Device"
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Not found error"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
      patch:
         summary: Update a device by id
         description: Update device metadata or apply a new configuration
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier (serial number) of the device
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: Name of the device
                           example: "Device_123"
                        configurationId:
                           type: string
                           description: ID of new configuration to assign to the device
                           example: "AKDJF139UGNLA12J"
                        notes:
                           type: string
                           description: Device notes
                           example: "This device was recently moved on 9/15"
                        tagIds:
                           type: array
                           items:
                              type: string
                           description: Ids of tags to apply to device
                           example: ["KADJFL2U4T", "AKLU32OI2QU5U"]
         responses:
            "200":
               description: Success
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Not found error"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/devices/sync-status:
      get:
         summary: List device sync status
         description: |
            Retrieve sync status details for devices. Currently supports fetching app sync statuses (installed vs. target version) only.

         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. Defaults to all organizations the API key has access to. 

                  **Multi-org API key limitation:** If your multi-org api key gives you access to more than 30 organizatinos, you must include a specific `organizationId` in this request.
            - name: include
              in: query
              required: true
              schema:
                 type: string
                 enum:
                    - apps
              description: |
                 Comma-separated list of content categories to include in the response. Currently only `apps` is supported. Required.
            - name: cursor
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Opaque pagination cursor returned in `nextCursor` by a prior response. Treat as opaque. Pass the nextCursor from the previous response back as cursor to fetch the next page. End of stream is indicated by nextCursor: null — do not infer end of stream from a short page.
            - name: limit
              in: query
              required: false
              schema:
                 type: integer
                 default: 400
                 maximum: 400
                 minimum: 1
              description: |
                 Maximum number of devices to return per page. Default and maximum are both 400.
         responses:
            "200":
               description: A page of device sync statuses
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1DeviceSyncStatus"
                           nextCursor:
                              type: string
                              nullable: true
                              description: Opaque cursor for the next page, or `null` if this is the last page.
            "400":
               description: Bad request — missing/invalid `include`, malformed `cursor`, invalid `limit`, or more than 30 organizations in scope.
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "include is required"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "include is required"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/devices/{id}/sync-status:
      get:
         summary: Get device sync status
         description: |
            Retrieve app sync status details for devices. For a device's overall up-to-date status, use the top-level `outOfDate` boolean on `GET /v1/devices/{id}`. This endpoint provides per-app detail.
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier (serial number) of the device.
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys.

                 Defaults to the organizationId associated with the API key.
            - name: include
              in: query
              required: true
              schema:
                 type: string
                 enum:
                    - apps
              description: |
                 Comma-separated list of content categories to include in the response. Currently only `apps` is supported. Required.
         responses:
            "200":
               description: The device's sync status
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1DeviceSyncStatus"
            "400":
               description: Bad request — missing or invalid `include`.
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "include is required"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "include is required"
                        error: "ManageXR Error"
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Device with id 12345678901234 not found"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/devices/set-pause-updates:
      post:
         summary: Set pause updates for devices
         description: |
            Pause or resume configuration updates for devices.

            Pausing configuration updates stops a device from syncing with its latest Configuration. User-initiated changes to Configurations and ManageXR-initiated updates to the ManageXR Admin App and Home Screen will not propagate to devices with updates paused.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        deviceIds:
                           type: array
                           items:
                              type: string
                           description: Array of device IDs (serial numbers) to update.
                        pauseUpdates:
                           type: boolean
                           description: Whether to pause (true) or resume (false) configuration updates.
                     required:
                        - deviceIds
                        - pauseUpdates
                  examples:
                     example-pause:
                        summary: Pause updates for devices
                        value:
                           deviceIds:
                              - 2G0YC1ZF630NZA
                              - PA7950RGGC06043
                           pauseUpdates: true
                     example-resume:
                        summary: Resume updates for devices
                        value:
                           deviceIds:
                              - 2G0YC1ZF630NZA
                              - PA7950RGGC06043
                           pauseUpdates: false
         responses:
            "200":
               description: Success
   /v1/devices/{id}/command:
      post:
         summary: Send command
         description: |
            Send command to a specific device

            <small>Available Commands: Launch App, Play/Pause Video, Launch Web Url, Disable/Enable Kiosk, Restart, Power Off, Set Volume, Set Brightness, Uninstall App, Sync, Enable/Disable Tutorial Mode</small>
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: The ID (serial number) of the device.
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     oneOf:
                        - title: Launch App
                          type: object
                          properties:
                             action:
                                type: string
                                required: true
                                description: Launch an application on the device.
                                enum:
                                   - LAUNCH_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      required: true
                                      description: The package name of the app to be launched
                                      example: "com.myapp.quest"
                                   launchParams:
                                      type: object
                                      description: |
                                         (Optional) Additional custom launch parameters

                                         e.g., { userId: 'ABC123', booleanValue: true, arrayValue: [1.23, 4.56], mapValue: { key: 'more stuff' }}
                                      example:
                                         userId: "ABC123"
                                         booleanValue: true
                                         floatValue: 100.29
                                         arrayValue: [1.23, 4.56]
                                         mapValue: { key: "more stuff" }
                                      required: false
                        - title: Play / Pause Video
                          type: object
                          properties:
                             action:
                                type: string
                                description: Play or pause video on the device.
                                enum:
                                   - PLAY_VIDEO
                                   - PAUSE_VIDEO
                                example: PLAY_VIDEO
                             data:
                                type: object
                                properties:
                                   videoId:
                                      type: string
                                      description: |
                                         The id of the video to play or pause. 

                                         To find a videoId, go to the video in your VR Content library on the Web Console and retrieve it from the url parameters (e.g. console.managexr.com/o/{orgId}/vr-content/edit/video/**FeWVcu7Rq4X3rmwGZGM6**).
                                   playFromBeginning:
                                      type: boolean
                                      description: (Optional) Plays video from the beginning. If falsy and the video is already open, play resumes from position.
                        - title: Launch Web Url
                          type: object
                          properties:
                             action:
                                type: string
                                description: Launch a specific webxr link on the device. Requires the data field to be populated (see below)
                                enum:
                                   - LAUNCH_WEB_URL
                                example: LAUNCH_WEB_URL
                             data:
                                type: object
                                properties:
                                   url:
                                      type: string
                                      description: The url of the webxr link to launch
                        - title: Disable / Enable Kiosk Mode
                          type: object
                          properties:
                             action:
                                type: string
                                description: |
                                   Override the device experience set on the Configuration. 

                                   `DISABLE_KIOSK` - Disable Kiosk Mode / ManageXR Home Screen on the device. Grants users full access to the default system menus. Sets `kioskModeOverride` flag on device to `true`.

                                   `ENABLE_KIOSK` - Re-Enable Kiosk Mode / ManageXR Home Screen on the device. Sets `kioskModeOverride` flag on device to `false`.

                                   _Note_, if the Configuration applied to a device uses Default Device Menus, the kioskModeOverride flag is a no-op.
                                enum:
                                   - DISABLE_KIOSK
                                   - ENABLE_KIOSK
                                example: DISABLE_KIOSK
                        - title: Restart
                          type: object
                          properties:
                             action:
                                type: string
                                description: Reboot the device.
                                enum:
                                   - RESTART
                                example: RESTART
                        - title: Power OFF
                          type: object
                          properties:
                             action:
                                type: string
                                description: Remotely turn off device. Supported on Meta Quest v77+ enrolled through MHMS, Pico Neo 3s PUI 5+, Pico 4 Ultra Enterprise devices.
                                enum:
                                   - POWER_OFF
                                example: POWER_OFF
                        - title: Set Volume
                          type: object
                          properties:
                             action:
                                type: string
                                description: Set volume on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_VOLUME
                                example: SET_VOLUME
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The volume level to set. Choose a value between 0 and 100.
                        - title: Set Brightness
                          type: object
                          properties:
                             action:
                                type: string
                                description: Set display brightness on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_BRIGHTNESS
                                example: SET_BRIGHTNESS
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The display brightness level to set. Choose a value between 0 and 100.
                        - title: Uninstall App
                          type: object
                          properties:
                             action:
                                type: string
                                description: |
                                   Uninstall an application on the device. 

                                   Cannot uninstall system apps. If you uninstall an app that is still on a devices's configuration, it will automatically re-download the next time the device syncs.
                                enum:
                                   - UNINSTALL_APP
                                example: UNINSTALL_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to uninstall
                        - title: Restart App
                          type: object
                          properties:
                             action:
                                type: string
                                description: Restart an app
                                enum:
                                   - RESTART_APP
                                example: RESTART_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to restart
                        - title: Sync
                          type: object
                          properties:
                             action:
                                type: string
                                description: Force device to check in with ManageXR. Online devices sync every 15 minutes or immediately when configuration changes are made.
                                enum:
                                   - SYNC
                                example: SYNC
                             data:
                                type: object
                                properties:
                                   forceSync:
                                      type: boolean
                                      description: Optional parameter. If true, forces device to sync immediately regardless of update schedule set on configuration
                        - title: Enable / Disable Tutorial Mode
                          type: object
                          properties:
                             action:
                                type: string
                                description: When Tutorial Mode in enabled, the device launches into its tutorial app on boot. Set the tutorial app in Configuration > Device Settings.
                                enum:
                                   - ENABLE_TUTORIAL_MODE
                                   - DISABLE_TUTORIAL_MODE
                                example: ENABLE_TUTORIAL_MODE
                  examples:
                     example-sync:
                        summary: Sync command
                        value:
                           action: SYNC
                     example-launch_app:
                        summary: Launch App command
                        value:
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                     example-launch_app_with_params:
                        summary: Launch app with parameters
                        value:
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                              launchParams:
                                 userId: AX3EIUf89
                                 booleanValue: true
                                 floatValue: 100.29
                                 arrayValue: [1.23, 4.56]
                                 mapValue:
                                    key: value
                     example-launch_webxr:
                        summary: Launch webxr link
                        value:
                           action: LAUNCH_WEB_URL
                           data:
                              url: https://google.com
         responses:
            "200":
               description: Success
            "400":
               description: Request must contain valid action
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Request must contain a valid action"
                           error:
                              type: string
                              example: "ManageXR Error"
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Not found error"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/devices/batch-command:
      post:
         summary: Send a command to multiple devices at once
         description: |
            Send a command to multiple devices at once

            <small>Available Commands: Launch App, Play/Pause Video, Launch Web Url, Disable/Enable Kiosk, Restart, Power Off, Set Volume, Set Brightness, Uninstall App, Sync, Enable/Disable Tutorial Mode </small>
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     oneOf:
                        - title: Launch App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                required: true
                                description: Launch an application on the devices
                                enum:
                                   - LAUNCH_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      required: true
                                      description: The package name of the app to be launched
                                      example: "com.myapp.quest"
                                   launchParams:
                                      type: object
                                      description: |
                                         (Optional) Additional custom launch parameters

                                         e.g., { userId: 'ABC123', booleanValue: true, arrayValue: [1.23, 4.56], mapValue: { key: 'more stuff' }}
                                      example:
                                         userId: "ABC123"
                                         booleanValue: true
                                         floatValue: 100.29
                                         arrayValue: [1.23, 4.56]
                                         mapValue: { key: "more stuff" }
                                      required: false
                        - title: Play / Pause Video
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Play or pause video on the devices
                                enum:
                                   - PLAY_VIDEO
                                   - PAUSE_VIDEO
                                example: PLAY_VIDEO
                             data:
                                type: object
                                properties:
                                   videoId:
                                      type: string
                                      description: |
                                         The id of the video to play or pause. 

                                         To find a videoId, go to the video in your VR Content library on the Web Console and retrieve it from the url parameters (e.g. console.managexr.com/o/{orgId}/vr-content/edit/video/**FeWVcu7Rq4X3rmwGZGM6**).
                                   playFromBeginning:
                                      type: boolean
                                      description: (Optional) Plays video from the beginning. If falsy and the video is already open, play resumes from position.
                        - title: Launch Web Url
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Launch a specific WebXR link on the devices. Requires the data field to be populated (see below)
                                enum:
                                   - LAUNCH_WEB_URL
                                example: LAUNCH_WEB_URL
                             data:
                                type: object
                                properties:
                                   url:
                                      type: string
                                      description: The url of the webxr link to launch
                        - title: Disable / Enable Kiosk Mode
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: |
                                   Override the device experience set on the Configuration. 

                                   `DISABLE_KIOSK` - Disable Kiosk Mode / ManageXR Home Screen on the devices. Grants users full access to the default system menus. Sets `kioskModeOverride` flag on devices to `true`.

                                   `ENABLE_KIOSK` - Re-Enable Kiosk Mode / ManageXR Home Screen on the devices. Sets `kioskModeOverride` flag on devices to `false`.

                                   _Note_, if the Configuration applied to a device uses Default Device Menus, the kioskModeOverride flag is a no-op.
                                enum:
                                   - DISABLE_KIOSK
                                   - ENABLE_KIOSK
                                example: DISABLE_KIOSK
                        - title: Restart
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Reboot the devices
                                enum:
                                   - RESTART
                                example: RESTART
                        - title: Power OFF
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Remotely turn off devices. Supported on Meta Quest v77+ enrolled through MHMS, Pico Neo 3s PUI 5+, Pico 4 Ultra Enterprise devices.
                                enum:
                                   - POWER_OFF
                                example: POWER_OFF
                        - title: Set Volume
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Set volume on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_VOLUME
                                example: SET_VOLUME
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The volume level to set. Choose a value between 0 and 100.
                        - title: Set Brightness
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Set brightness on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_BRIGHTNESS
                                example: SET_BRIGHTNESS
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The brightness level to set. Choose a value between 0 and 100.
                        - title: Uninstall App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: |
                                   Uninstall an application on the devices. 

                                   Cannot uninstall system apps. If you uninstall an app that is still on a devices's configuration, it will automatically re-download the next time the device syncs.
                                enum:
                                   - UNINSTALL_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to uninstall
                        - title: Restart App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Restart an app
                                enum:
                                   - RESTART_APP
                                example: RESTART_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to restart
                        - title: Sync
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Force devices to check in with ManageXR. Online devices sync every 15 minutes or immediately when configuration changes are made.
                                enum:
                                   - SYNC
                                example: SYNC
                             data:
                                type: object
                                properties:
                                   forceSync:
                                      type: boolean
                                      description: Optional parameter. If true, forces device to sync immediately regardless of update schedule set on configuration
                        - title: Enable / Disable Tutorial Mode
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: When Tutorial Mode in enabled, the devices launch into their tutorial app on boot. Set the tutorial app in Configuration > Device Settings.
                                enum:
                                   - ENABLE_TUTORIAL_MODE
                                   - DISABLE_TUTORIAL_MODE
                                example: ENABLE_TUTORIAL_MODE
                  examples:
                     example-sync:
                        summary: Sync command
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: SYNC
                     example-launch_app:
                        summary: Launch App command
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                     example-launch_app_with_params:
                        summary: Launch app with parameters
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                              launchParams:
                                 userId: AX3EIUf89
                                 booleanValue: true
                                 floatValue: 100.29
                                 arrayValue: [1.23, 4.56]
                                 mapValue:
                                    key: value
                     example-launch_webxr:
                        summary: Launch webxr link
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_WEB_URL
                           data:
                              url: https://google.com
         responses:
            "200":
               description: Success
            "400":
               description: Request must contain valid action
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Request must contain a valid action"
                           error:
                              type: string
                              example: "ManageXR Error"
            "404":
               description: Device not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Not found error"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   ##################################################
   # Files
   ##################################################
   /v1/files/:
      get:
         summary: List files in organization
         description: List all files present in the organization's library
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: An array of all files in the organization
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 oneOf:
                                    - $ref: "#/components/schemas/V1ManagedFile"
      post:
         summary: Create self-hosted files
         description: |
            Create self-hosted files in your ManageXR Files library. 

            Once created, you can use Edit App Version or [Edit Configuration](https://docs.managexr.com/api-reference/endpoint/v1/edit-configuration) to deploy the file with an app version or on a configuration, respectively.

            To create files hosted on ManageXR's servers, use the [ManageXR CLI](https://docs.managexr.com/cli-reference/introduction)
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: array
                     description: Array of self-hosted files to create.
                     items:
                        oneOf:
                           - $ref: "#/components/schemas/V1ManagedFileDto"
                  example:
                     - url: "https://my-bucket-name.s3.amazonaws.com/main_assets_all.bundle"
                       name: "main_assets_all.bundle"
                       size: 1204975930
                       md5: "7ah69cMtXyaz5OfsCRtOjQ=="
                       description: "Content bundle for training app"
                       libraryDirectoryPath: "/com.managexr.demoTrainingApp/"
                     - url: "https://my-bucket-name.s3.amazonaws.com/module2-assets.bundle"
                       name: "module2-assets.bundle"
                       size: 1204975930
                       md5: "7ah69cMtXyaz5OfsCRtOjQ=="
                       description: "Assets for module 2 of training app"
                       libraryDirectoryPath: "/com.managexr.demoTrainingApp/"
   ##################################################
   # Apps
   ##################################################
   /v1/apps/:
      get:
         summary: List apps in organization
         description: List all applications present in organization. This lists top-level application info. To access app versions and specific version info, use [List App Versions](https://docs.managexr.com/api-reference/endpoint/v1/list-app-versions)
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of app profiles
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 type: object
                                 properties:
                                    packageName:
                                       type: string
                                       description: Package name of the app
                                       example: "com.example.app"
                                    title:
                                       type: string
                                       description: Title of the app
                                       example: "My Awesome App"
                                    description:
                                       type: string
                                       description: Description of the app
                                       example: "A fantastic app for managing XR content"
                                    categories:
                                       type: array
                                       items:
                                          type: string
                                       description: Categories the app belongs to
                                       example: ["Education", "Productivity"]
                                    iconUrl:
                                       type: string
                                       format: uri
                                       description: URL of the app's icon
                                       example: "https://storage.example.com/apps/com.example.app/icon.png"
                                    numVersions:
                                       type: number
                                       description: Number of versions of the app
                                       example: 5
                     example:
                        data:
                           - packageName: "com.example.app"
                             title: "My Awesome App"
                             description: "A fantastic app for managing XR content"
                             categories: ["Education", "Productivity"]
                             iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
                             numVersions: 5
                           - packageName: "com.another.app"
                             title: "Another App"
                             description: "Another great app for XR"
                             categories: ["Training", "Simulation"]
                             iconUrl: "https://storage.example.com/apps/com.another.app/icon.png"
                             numVersions: 3
      post:
         summary: Create managed app (self-hosted)
         description: Create a managed app (Self-Hosted Only). Add an applictation to your ManageXR library that you are hosting on your own servers. To create and upload an application to our servers, use the [ManageXR CLI](https://docs.managexr.com/cli-reference/command/upload-app).
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        packageName:
                           type: string
                           description: Package name of the app
                           example: "com.example.app"
                        title:
                           type: string
                           description: Title of the app
                           example: "My Awesome App"
                        versionCode:
                           type: number
                           description: Version code of the app
                           example: 42
                        apkUrl:
                           type: string
                           description: URL of the APK file
                           example: "https://storage.example.com/apps/com.example.app.apk"
                        apkMd5:
                           type: string
                           description: MD5 hash of the APK file
                           example: "d41d8cd98f00b204e9800998ecf8427e"
                        obbUrl:
                           type: string
                           description: URL of the OBB file
                           example: "https://storage.example.com/apps/com.example.app.obb"
                        obbMd5:
                           type: string
                           description: MD5 hash of the OBB file
                           example: "d41d8cd98f00b204e9800998ecf8427e"
                        versionName:
                           type: string
                           description: Version name of the app
                           example: "1.0.0"
                        versionLabel:
                           type: string
                           description: Label for uniqueness among app versions
                           example: "Quest"
                        apkSize:
                           type: number
                           description: Size of the APK file in bytes
                           example: 72633861
                        obbSize:
                           type: number
                           description: Size of the OBB file in bytes
                           example: 1024
                        iconUrl:
                           type: string
                           format: uri
                           description: URL of the app's icon
                           example: "https://storage.example.com/apps/com.example.app/icon.png"
                     required:
                        - packageName
                        - title
                        - versionCode
                        - apkUrl
                        - versionName
                  example:
                     packageName: "com.example.app"
                     title: "My Awesome App"
                     versionCode: 42
                     apkUrl: "https://storage.example.com/apps/com.example.app.apk"
                     apkMd5: "d41d8cd98f00b204e9800998ecf8427e"
                     obbUrl: "https://storage.example.com/apps/com.example.app.obb"
                     obbMd5: "d41d8cd98f00b204e9800998ecf8427e"
                     versionName: "1.0.0"
                     versionLabel: "Quest"
                     apkSize: 72633861
                     obbSize: 1024
                     iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
         responses:
            "200":
               description: The created managed app version
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the app version
                                    example: "av_123"
                                 type:
                                    type: string
                                    enum: [managed]
                                    description: Type of the app version
                                    example: "managed"
                                 createdAt:
                                    type: number
                                    description: Creation timestamp
                                    example: 1645615777448
                                 updatedAt:
                                    type: number
                                    description: Last update timestamp
                                    example: 1687352117203
                                 versionCode:
                                    type: number
                                    description: Version code of the app
                                    example: 83894522
                                 versionName:
                                    type: string
                                    description: Version name of the app
                                    example: "8.7.8.1206"
                                 versionLabel:
                                    type: string
                                    description: Label for uniqueness among app versions
                                    example: "Quest"
                                 apkSize:
                                    type: number
                                    description: Size of the APK file in bytes
                                    example: 72633861
                                 obbSize:
                                    type: number
                                    description: Size of the OBB file in bytes
                                    example: 1024
                                 selfHosted:
                                    type: boolean
                                    description: Whether the app is self-hosted
                                    example: true
                                 apkUrl:
                                    type: string
                                    description: URL of the APK file
                                    example: "https://storage.example.com/apps/com.example.app.apk"
                                 obbUrl:
                                    type: string
                                    description: URL of the OBB file
                                    example: "https://storage.example.com/apps/com.example.app.obb"
                     example:
                        data:
                           id: "av_123"
                           type: "managed"
                           configurationDeployments:
                              { "config_123": 1, "config_456": 0 }
                           createdAt: 1645615777448
                           updatedAt: 1687352117203
                           versionCode: 83894522
                           versionName: "8.7.8.1206"
                           versionLabel: "Quest"
                           apkSize: 72633861
                           obbSize: 1024
                           selfHosted: true
                           apkUrl: "https://storage.example.com/apps/com.example.app.apk"
                           obbUrl: "https://storage.example.com/apps/com.example.app.obb"
            "400":
               description: Invalid request
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Invalid request"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Invalid request"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/apps/{packageName}:
      get:
         summary: Get app information by package name
         description: Returns information about a specific app including the title, iconUrl, categories, and number of versions.
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: The app profile
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 title:
                                    type: string
                                    description: Title of the app
                                    example: "My Awesome App"
                                 description:
                                    type: string
                                    description: Description of the app
                                    example: "A fantastic app for managing XR content"
                                 categories:
                                    type: array
                                    items:
                                       type: string
                                    description: Categories the app belongs to
                                    example: ["Education", "Productivity"]
                                 iconUrl:
                                    type: string
                                    format: uri
                                    description: URL of the app's icon
                                    example: "https://storage.example.com/apps/com.example.app/icon.png"
                                 numVersions:
                                    type: number
                                    description: Number of versions of the app
                                    example: 5
                     example:
                        data:
                           packageName: "com.example.app"
                           title: "My Awesome App"
                           description: "A fantastic app for managing XR content"
                           categories: ["Education", "Productivity"]
                           iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
                           numVersions: 5
            "404":
               description: App not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "App with package name com.example.app not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "App with package name com.example.app not found"
                        error: "ManageXR Error"
      patch:
         summary: Edit app
         description: Update an app's metadata such as title, description, categories, and icon URL
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: type
              in: query
              required: false
              schema:
                 type: string
                 enum: [managed, shared, instant]
                 description: Type of the app version to update
              description: Type of the app version to update
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        title:
                           type: string
                           description: Title of the app
                           example: "My Awesome App"
                        description:
                           type: string
                           description: Description of the app
                           example: "A fantastic app for managing XR content"
                        categories:
                           type: array
                           items:
                              type: string
                           description: Home screen categories the app belongs to
                           example: ["Education", "Productivity"]
                        iconUrl:
                           type: string
                           format: uri
                           description: URL of the app's icon
                           example: "https://storage.example.com/apps/com.example.app/icon.png"
                  example:
                     title: "My Awesome App"
                     description: "A fantastic app for managing XR content"
                     categories: ["Education", "Productivity"]
                     iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
         responses:
            "200":
               description: The updated app profile
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 title:
                                    type: string
                                    description: Title of the app
                                    example: "My Awesome App"
                                 description:
                                    type: string
                                    description: Description of the app
                                    example: "A fantastic app for managing XR content"
                                 categories:
                                    type: array
                                    items:
                                       type: string
                                    description: Categories the app belongs to
                                    example: ["Education", "Productivity"]
                                 iconUrl:
                                    type: string
                                    format: uri
                                    description: URL of the app's icon
                                    example: "https://storage.example.com/apps/com.example.app/icon.png"
                                 numVersions:
                                    type: number
                                    description: Number of versions of the app
                                    example: 5
                     example:
                        data:
                           packageName: "com.example.app"
                           title: "My Awesome App"
                           description: "A fantastic app for managing XR content"
                           categories: ["Education", "Productivity"]
                           iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
                           numVersions: 5
            "400":
               description: Invalid request
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Invalid app type: external"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Invalid app type: external"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: App not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "App with package name com.example.app not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "App with package name com.example.app not found"
                        error: "ManageXR Error"
      delete:
         summary: Delete app
         description: Removes application and all versions from ManageXR.

         parameters:
            - name: packageName
              in: path
              required: true
              schema: { type: string }
              description: The package name of the app
            - name: type
              in: query
              required: false
              schema:
                 type: string
                 enum: [managed, shared, instant, external]
                 default: managed
              description: |
                 App **type** to delete.  
                 • If not set, defaults to **managed**.  

                  **Behavior by type**

                  | type      | Deletion scope |
                  |-----------|---------------|
                  | managed   | Deletes the managed app and **all managed versions**. |
                  | shared    | Deletes the shared app for *your* organization only (the owner org keeps its copy). |
                  | instant   | Deletes the instant app for *your* organization only (the owner org keeps its copy). |
                  | external  | Deletes the external app. |
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.

         responses:
            "200":
               description: App deleted successfully
            "400":
               description: Invalid app type
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 400 }
                           message:
                              { type: string, example: "Invalid app type: foo" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 400
                        message: "Invalid app type: foo"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: App not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "App with package name com.example.app not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "App with package name com.example.app not found"
                        error: "ManageXR Error"
   /v1/apps/{packageName}/versions:
      get:
         summary: List app versions
         description: Returns a list of all app versions for a given package name
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of app versions
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       description: Unique identifier of the app version
                                       example: "av_123"
                                    type:
                                       type: string
                                       enum:
                                          [managed, shared, external, instant]
                                       description: Type of the app version
                                       example: "managed"
                                    configurationDeployments:
                                       type: object
                                       description: Map of configuration ids to device count using application
                                       example:
                                          { "config_123": 1, "config_456": 0 }
                                    createdAt:
                                       type: number
                                       description: Creation timestamp
                                       example: 1645615777448
                                    updatedAt:
                                       type: number
                                       description: Last update timestamp
                                       example: 1687352117203
                                    versionCode:
                                       type: number
                                       description: Version code of the app
                                       example: 83894522
                                    versionName:
                                       type: string
                                       description: Version name of the app
                                       example: "8.7.8.1206"
                                    versionLabel:
                                       type: string
                                       description: Label for uniqueness among app versions
                                       example: "Quest"
                                    apkSize:
                                       type: number
                                       description: Size of the APK file in bytes
                                       example: 72633861
                                    obbSize:
                                       type: number
                                       description: Size of the OBB file in bytes
                                       example: 1024
                                    selfHosted:
                                       type: boolean
                                       description: Whether the app is self-hosted
                                       example: true
                                    apkUrl:
                                       type: string
                                       description: URL of the APK file (self-hosted apps only)
                                       example: "https://storage.example.com/apps/com.example.app.apk"
                                    obbUrl:
                                       type: string
                                       description: URL of the OBB file (self-hosted apps only)
                                       example: "https://storage.example.com/apps/com.example.app.obb"
                                    sharingOrganizationName:
                                       type: string
                                       description: Name of the organization sharing the app (shared apps only)
                                       example: "XR Developer"
                                    releaseChannelName:
                                       type: string
                                       description: Name of the release channel (shared apps only)
                                       example: "Production"
                                    supportedDeviceModels:
                                       type: array
                                       items:
                                          type: string
                                          example: "Quest 3"
                                       description: List of supported device models for Instant App (instant apps only)
                                       example:
                                          [
                                             "Quest 3",
                                             "Quest 3S",
                                             "Pico 4 Ultra Enterprise",
                                          ]
                     example:
                        data:
                           - id: "av_123"
                             type: "managed"
                             configurationDeployments:
                                { "config_123": 1, "config_456": 0 }
                             createdAt: 1645615777448
                             updatedAt: 1687352117203
                             versionCode: 83894522
                             versionName: "8.7.8.1206"
                             versionLabel: "Quest"
                             apkSize: 72633861
                             obbSize: 1024
                             selfHosted: true
                             apkUrl: "https://storage.example.com/apps/com.example.app.apk"
                             obbUrl: "https://storage.example.com/apps/com.example.app.obb"
                           - id: "av_456"
                             type: "shared"
                             configurationDeployments:
                                { "config_123": 0, "config_456": 1 }
                             createdAt: 1645615777448
                             updatedAt: 1687352117203
                             versionCode: 83894522
                             versionName: "8.7.8.1206"
                             versionLabel: "Quest"
                             apkSize: 72633861
                             obbSize: 1024
                             selfHosted: false
                             releaseChannelName: "Production"
                             sharingOrganizationName: "XR Developer"
            "404":
               description: App not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "App with package name com.example.app not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "App with package name com.example.app not found"
                        error: "ManageXR Error"
      post:
         summary: Create app version (self-hosted)
         description: Create a managed app version (Self-Hosted Only). Adds a new version of a self-hosted application. To create and upload a new app version to our servers, use the [ManageXR CLI](https://docs.managexr.com/cli-reference/command/upload-app)
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        versionCode:
                           type: number
                           description: Version code of the app
                           example: 42
                        apkUrl:
                           type: string
                           description: URL of the APK file
                           example: "https://storage.example.com/apps/com.example.app.apk"
                        apkMd5:
                           type: string
                           description: MD5 hash of the APK file
                           example: "d41d8cd98f00b204e9800998ecf8427e"
                        obbUrl:
                           type: string
                           description: URL of the OBB file
                           example: "https://storage.example.com/apps/com.example.app.obb"
                        obbMd5:
                           type: string
                           description: MD5 hash of the OBB file
                           example: "d41d8cd98f00b204e9800998ecf8427e"
                        versionName:
                           type: string
                           description: Version name of the app
                           example: "1.0.0"
                        versionLabel:
                           type: string
                           description: Label for uniqueness among app versions
                           example: "Quest"
                        apkSize:
                           type: number
                           description: Size of the APK file in bytes
                           example: 72633861
                        obbSize:
                           type: number
                           description: Size of the OBB file in bytes
                           example: 1024
                     required:
                        - versionCode
                        - apkUrl
                        - versionName
                  example:
                     versionCode: 42
                     apkUrl: "https://storage.example.com/apps/com.example.app.apk"
                     apkMd5: "d41d8cd98f00b204e9800998ecf8427e"
                     obbUrl: "https://storage.example.com/apps/com.example.app.obb"
                     obbMd5: "d41d8cd98f00b204e9800998ecf8427e"
                     versionName: "1.0.0"
                     versionLabel: "Quest"
                     apkSize: 72633861
                     obbSize: 1024
         responses:
            "200":
               description: The created app version
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the app version
                                    example: "av_123"
                                 type:
                                    type: string
                                    enum: [managed, shared, external, instant]
                                    description: Type of the app version
                                    example: "managed"
                                 createdAt:
                                    type: number
                                    description: Creation timestamp
                                    example: 1645615777448
                                 updatedAt:
                                    type: number
                                    description: Last update timestamp
                                    example: 1687352117203
                                 versionCode:
                                    type: number
                                    description: Version code of the app
                                    example: 83894522
                                 versionName:
                                    type: string
                                    description: Version name of the app
                                    example: "8.7.8.1206"
                                 versionLabel:
                                    type: string
                                    description: Label for uniqueness among app versions
                                    example: "Quest"
                                 apkSize:
                                    type: number
                                    description: Size of the APK file in bytes
                                    example: 72633861
                                 obbSize:
                                    type: number
                                    description: Size of the OBB file in bytes
                                    example: 1024
                                 selfHosted:
                                    type: boolean
                                    description: Whether the app is self-hosted
                                    example: true
                                 apkUrl:
                                    type: string
                                    description: URL of the APK file (only present if self-hosted)
                                    example: "https://storage.example.com/apps/com.example.app.apk"
                                 obbUrl:
                                    type: string
                                    description: URL of the OBB file (only present if self-hosted)
                                    example: "https://storage.example.com/apps/com.example.app.obb"
                     example:
                        data:
                           id: "av_123"
                           type: "managed"
                           configurationDeployments:
                              { "config_123": 1, "config_456": 0 }
                           createdAt: 1645615777448
                           updatedAt: 1687352117203
                           versionCode: 83894522
                           versionName: "8.7.8.1206"
                           versionLabel: "Quest"
                           apkSize: 72633861
                           obbSize: 1024
                           selfHosted: true
                           apkUrl: "https://storage.example.com/apps/com.example.app.apk"
                           obbUrl: "https://storage.example.com/apps/com.example.app.obb"
            "400":
               description: Invalid request
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Invalid request"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Invalid request"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/apps/{packageName}/versions/{versionId}:
      patch:
         summary: Edit app version
         description: Edit a managed app version. Apply a new version label or edit the app version's bundled files.
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: versionId
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the app version
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        versionLabel:
                           type: string
                           description: Label for uniqueness among app versions
                           example: "Quest"
                        files:
                           type: array
                           items:
                              oneOf:
                                 - $ref: "#/components/schemas/V1BundledFileEditDto"
                  example:
                     versionLabel: "Quest"
         responses:
            "200":
               description: Success
            "400":
               description: Invalid request
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Invalid request"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Invalid request"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: App with version id {versionId} not found!
                           error:
                              type: string
                              example: Not Found
                     example:
                        statusCode: 404
                        message: App with version id {versionId} not found!
                        error: Not Found

      delete:
         summary: Delete app version
         description: |
            Deletes a specific app version

            | App type      | Deletion scope |
            |---------------|---------------|
            | managed  app | Deletes the specified managed app version. This also deletes all release channels that target this managed version. See [Delete release channel](https://docs.managexr.com/api-reference/endpoint/v1/delete-app-release-channel). |
            | shared   app | Deletes the specified shared version in the recipient organization only (owner org keeps its copy) |

         parameters:
            - name: packageName
              in: path
              required: true
              schema: { type: string }
              description: The package name of the app
            - name: versionId
              in: path
              required: true
              schema: { type: string }
              description: Unique identifier of the app version
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.

         responses:
            "200":
               description: App version deleted successfully
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: App version not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "App version with id av_123 not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "App version with id av_123 not found"
                        error: "ManageXR Error"

   /v1/apps/{packageName}/release-channels:
      get:
         summary: List app release channels
         description: Returns a list of all release channels for a given application
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of release channels
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       description: Unique identifier of the release channel
                                       example: "rc_123"
                                    name:
                                       type: string
                                       description: Name of the release channel
                                       example: "Stable"
                                    type:
                                       type: string
                                       enum: [app, link, video]
                                       description: Type of the release channel
                                       example: "app"
                                    packageName:
                                       type: string
                                       description: Package name of the app
                                       example: "com.example.app"
                                    targetVersion:
                                       type: object
                                       description: The target app version for this release channel
                                       properties:
                                          id:
                                             type: string
                                             description: Unique identifier of the app version
                                             example: "av_123"
                                          type:
                                             type: string
                                             enum:
                                                [
                                                   managed,
                                                   shared,
                                                   external,
                                                   instant,
                                                ]
                                             description: Type of the app version
                                             example: "managed"
                                          configurationDeployments:
                                             type: object
                                             description: Map of configuration ids to device count using application
                                             example:
                                                {
                                                   "config_123": 1,
                                                   "config_456": 0,
                                                }
                                          createdAt:
                                             type: number
                                             description: Creation timestamp
                                             example: 1645615777448
                                          updatedAt:
                                             type: number
                                             description: Last update timestamp
                                             example: 1687352117203
                                          versionCode:
                                             type: number
                                             description: Version code of the app
                                             example: 83894522
                                          versionName:
                                             type: string
                                             description: Version name of the app
                                             example: "8.7.8.1206"
                                          apkSize:
                                             type: number
                                             description: Size of the APK file in bytes
                                             example: 72633861
                                          selfHosted:
                                             type: boolean
                                             description: Whether the app is self-hosted
                                             example: false
                                    sharedOrganizations:
                                       type: array
                                       description: List of organizations this release channel is shared with
                                       items:
                                          type: object
                                          properties:
                                             id:
                                                type: string
                                                description: Unique identifier of the organization
                                                example: "org_789"
                                             name:
                                                type: string
                                                description: Name of the organization
                                                example: "Example Org"
                     example:
                        data:
                           - id: "rc_123"
                             name: "Stable"
                             type: "app"
                             packageName: "com.example.app"
                             targetVersion:
                                id: "av_123"
                                type: "managed"
                                configurationDeployments:
                                   { "config_123": 1, "config_456": 0 }
                                createdAt: 1645615777448
                                updatedAt: 1687352117203
                                versionCode: 83894522
                                versionName: "8.7.8.1206"
                                apkSize: 72633861
                                selfHosted: false
                             sharedOrganizations:
                                - id: "org_789"
                                  name: "Example Org"
                           - id: "rc_456"
                             name: "Beta"
                             type: "app"
                             packageName: "com.example.app"
                             targetVersion:
                                id: "av_456"
                                type: "shared"
                                configurationDeployments:
                                   { "config_123": 0, "config_456": 1 }
                                createdAt: 1645615777448
                                updatedAt: 1687352117203
                                versionCode: 83894522
                                versionName: "8.7.8.1206"
                                apkSize: 72633861
                                selfHosted: false
                             sharedOrganizations: []
      post:
         summary: Create an app release channel
         description: Add a new release channel for an app and assign it an app version
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: Name of the release channel
                           example: "Stable"
                        targetVersion:
                           oneOf:
                              - type: object
                                properties:
                                   versionCode:
                                      type: number
                                      description: Version code of the app
                                      example: 42
                                   versionName:
                                      type: string
                                      description: Version name of the app
                                      example: "1.0.0"
                                   versionLabel:
                                      type: string
                                      description: Label for uniqueness among app versions
                                      example: "Quest"
                              - type: string
                                enum: [latest, last-created]
                                description: Special version identifier. "latest" = latest semver version. "last-created" = most recently created on ManageXR.
                                example: "latest"
                              - type: string
                                description: App version ID
                                example: "av_123"
                     required:
                        - name
                        - targetVersion
                  examples:
                     example-latest:
                        summary: Create release channel with latest version
                        value:
                           name: "Stable"
                           targetVersion: "latest"
                     example-last-created:
                        summary: Create release channel with most recently created version
                        value:
                           name: "Beta"
                           targetVersion: "last-created"
                     example-specific-version:
                        summary: Create release channel with specific version
                        value:
                           name: "Production"
                           targetVersion:
                              versionCode: 42
                              versionName: "1.0.0"
                     example-specific-version-with-label:
                        summary: Create release channel with specific version and label
                        value:
                           name: "Quest Release"
                           targetVersion:
                              versionCode: 42
                              versionName: "1.0.0"
                              versionLabel: "Quest"
                     example-app-id:
                        summary: Create release channel with app version ID
                        value:
                           name: "Stable"
                           targetVersion: "av_123"
         responses:
            "200":
               description: The created release channel
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the release channel
                                    example: "rc_123"
                                 name:
                                    type: string
                                    description: Name of the release channel
                                    example: "Stable"
                                 type:
                                    type: string
                                    enum: [app, link, video]
                                    description: Type of the release channel
                                    example: "app"
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 targetVersion:
                                    type: object
                                    description: The target app version for this release channel
                                    properties:
                                       id:
                                          type: string
                                          description: Unique identifier of the app version
                                          example: "av_123"
                                       type:
                                          type: string
                                          enum:
                                             [
                                                managed,
                                                shared,
                                                external,
                                                instant,
                                             ]
                                          description: Type of the app version
                                          example: "managed"
                                       configurationDeployments:
                                          type: object
                                          description: Map of configuration ids to device count using application
                                          example:
                                             {
                                                "config_123": 1,
                                                "config_456": 0,
                                             }
                                       createdAt:
                                          type: number
                                          description: Creation timestamp
                                          example: 1645615777448
                                       updatedAt:
                                          type: number
                                          description: Last update timestamp
                                          example: 1687352117203
                                       versionCode:
                                          type: number
                                          description: Version code of the app
                                          example: 83894522
                                       versionName:
                                          type: string
                                          description: Version name of the app
                                          example: "8.7.8.1206"
                                       apkSize:
                                          type: number
                                          description: Size of the APK file in bytes
                                          example: 72633861
                                       selfHosted:
                                          type: boolean
                                          description: Whether the app is self-hosted
                                          example: false
                                 sharedOrganizations:
                                    type: array
                                    description: List of organizations this release channel is shared with
                                    items:
                                       type: object
                                       properties:
                                          id:
                                             type: string
                                             description: Unique identifier of the organization
                                             example: "org_789"
                                          name:
                                             type: string
                                             description: Name of the organization
                                             example: "Example Org"
                     example:
                        data:
                           id: "rc_123"
                           name: "Stable"
                           type: "app"
                           packageName: "com.example.app"
                           targetVersion:
                              id: "av_123"
                              type: "managed"
                              configurationDeployments:
                                 { "config_123": 1, "config_456": 0 }
                              createdAt: 1645615777448
                              updatedAt: 1687352117203
                              versionCode: 83894522
                              versionName: "8.7.8.1206"
                              apkSize: 72633861
                              selfHosted: false
                           sharedOrganizations:
                              - id: "org_789"
                                name: "Example Org"
            "400":
               description: Release channel package name mismatch
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "App matching version identifier not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "App matching version identifier not found"
                        error: "ManageXR Error"
   /v1/apps/{packageName}/release-channels/{releaseChannelId}:
      patch:
         summary: Edit a release channel
         description: Update the target app version or name of an existing app release channel
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: releaseChannelId
              in: path
              required: true
              schema:
                 type: string
              description: The unique identifier of the release channel
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: New name for the release channel
                           example: "Production"
                        targetVersion:
                           oneOf:
                              - type: object
                                properties:
                                   versionCode:
                                      type: number
                                      description: Version code of the app
                                      example: 42
                                   versionName:
                                      type: string
                                      description: Version name of the app
                                      example: "1.0.0"
                                   versionLabel:
                                      type: string
                                      description: Label for uniqueness among app versions
                                      example: "Quest"
                              - type: string
                                enum: [latest, last-created]
                                description: Special version identifier. "latest" = latest semver version. "last-created" = most recently created on ManageXR.
                                example: "latest"
                              - type: string
                                description: App version ID
                                example: "av_123"
                  examples:
                     example-name-only:
                        summary: Update only the release channel name
                        value:
                           name: "Stable"
                     example-latest:
                        summary: Update to the latest version
                        value:
                           targetVersion: "latest"
                     example-last-created:
                        summary: Update to the most recently created version
                        value:
                           targetVersion: "last-created"
                     example-specific-version:
                        summary: Update to a specific version with version code and name
                        value:
                           targetVersion:
                              versionCode: 42
                              versionName: "1.0.0"
                     example-specific-version-with-label:
                        summary: Update to a specific version with version code, name, and label
                        value:
                           targetVersion:
                              versionCode: 42
                              versionName: "1.0.0"
                              versionLabel: "Release"
                     example-app-id:
                        summary: Update to a specific version using app version ID
                        value:
                           targetVersion: "av_123"
                     example-name-and-version:
                        summary: Update both name and version
                        value:
                           name: "Stable"
                           targetVersion: "latest"
         responses:
            "200":
               description: The updated release channel
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the release channel
                                    example: "rc_123"
                                 name:
                                    type: string
                                    description: Name of the release channel
                                    example: "Stable"
                                 type:
                                    type: string
                                    enum: [app, link, video]
                                    description: Type of the release channel
                                    example: "app"
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 targetVersion:
                                    type: object
                                    description: The target app version for this release channel
                                    properties:
                                       id:
                                          type: string
                                          description: Unique identifier of the app version
                                          example: "av_123"
                                       type:
                                          type: string
                                          enum:
                                             [
                                                managed,
                                                shared,
                                                external,
                                                instant,
                                             ]
                                          description: Type of the app version
                                          example: "managed"
                                       configurationDeployments:
                                          type: object
                                          description: Map of configuration ID to device count using application
                                          example:
                                             {
                                                "config_123": 1,
                                                "config_456": 0,
                                             }
                                       createdAt:
                                          type: number
                                          description: Creation timestamp
                                          example: 1645615777448
                                       updatedAt:
                                          type: number
                                          description: Last update timestamp
                                          example: 1687352117203
                                       versionCode:
                                          type: number
                                          description: Version code of the app
                                          example: 83894522
                                       versionName:
                                          type: string
                                          description: Version name of the app
                                          example: "8.7.8.1206"
                                 apkSize:
                                    type: number
                                    description: Size of the APK file in bytes
                                    example: 72633861
                                 selfHosted:
                                    type: boolean
                                    description: Whether the app is self-hosted
                                    example: false
                                 sharedOrganizations:
                                    type: array
                                    description: List of organizations this release channel is shared with
                                    items:
                                       type: object
                                       properties:
                                          id:
                                             type: string
                                             description: Unique identifier of the organization
                                             example: "org_789"
                                          name:
                                             type: string
                                             description: Name of the organization
                                             example: "Example Org"
                     example:
                        data:
                           id: "rc_123"
                           name: "Stable"
                           type: "app"
                           packageName: "com.example.app"
                           targetVersion:
                              id: "av_123"
                              type: "managed"
                              configurationDeployments:
                                 { "config_123": 1, "config_456": 0 }
                              createdAt: 1645615777448
                              updatedAt: 1687352117203
                              versionCode: 83894522
                              versionName: "8.7.8.1206"
                              selfHosted: false
                           sharedOrganizations:
                              - id: "org_789"
                                name: "Example Org"
            "400":
               description: Release channel package name mismatch
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Release channel with id rc_123 does not match the provided package name com.example.app"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Release channel with id rc_123 does not match the provided package name com.example.app"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Release channel not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Release channel with id rc_123 not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Release channel with id rc_123 not found"
                        error: "ManageXR Error"
      delete:
         summary: Delete release channel
         description: |
            Deletes an app release channel. If shared with client organizations, deleting also unshares the release channel.
         parameters:
            - name: packageName
              in: path
              required: true
              schema: { type: string }
              description: Package name of the app
            - name: releaseChannelId
              in: path
              required: true
              schema: { type: string }
              description: Unique identifier of the release channel
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.

         responses:
            "200":
               description: Release channel deleted successfully
            "400":
               description: Release channel package name mismatch
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Release channel with id rc_123 does not match the provided package name com.example.app"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Release channel with id rc_123 does not match the provided package name com.example.app"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Release channel not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "Release channel with id rc_123 not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "Release channel with id rc_123 not found"
                        error: "ManageXR Error"
   /v1/apps/{packageName}/release-channels/{releaseChannelId}/share:
      post:
         summary: Share a release channel
         description: Share an app release channel with a client organization. The API key used must be a multi-org key with access to the client organizations to use this endpoint.
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: releaseChannelId
              in: path
              required: true
              schema:
                 type: string
              description: The unique identifier of the release channel
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        organizationIds:
                           type: array
                           items:
                              type: string
                           description: Array of organization IDs to share the release channel with
                           example: ["org_123", "org_456"]
                     required:
                        - organizationIds
                  example:
                     organizationIds: ["org_123", "org_456"]
         responses:
            "200":
               description: The updated release channel
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the release channel
                                    example: "rc_123"
                                 name:
                                    type: string
                                    description: Name of the release channel
                                    example: "Stable"
                                 type:
                                    type: string
                                    enum: [app, link, video]
                                    description: Type of the release channel
                                    example: "app"
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 targetVersion:
                                    type: object
                                    description: The target app version for this release channel
                                    properties:
                                       id:
                                          type: string
                                          description: Unique identifier of the app version
                                          example: "av_123"
                                       type:
                                          type: string
                                          enum:
                                             [
                                                managed,
                                                shared,
                                                external,
                                                instant,
                                             ]
                                          description: Type of the app version
                                          example: "managed"
                                       configurationDeployments:
                                          type: object
                                          description: Map of configuration ID to device count using application
                                          example:
                                             {
                                                "config_123": 1,
                                                "config_456": 0,
                                             }
                                       createdAt:
                                          type: number
                                          description: Creation timestamp
                                          example: 1645615777448
                                       updatedAt:
                                          type: number
                                          description: Last update timestamp
                                          example: 1687352117203
                                       versionCode:
                                          type: number
                                          description: Version code of the app
                                          example: 83894522
                                       versionName:
                                          type: string
                                          description: Version name of the app
                                          example: "8.7.8.1206"
                                       apkSize:
                                          type: number
                                          description: Size of the APK file in bytes
                                          example: 72633861
                                       selfHosted:
                                          type: boolean
                                          description: Whether the app is self-hosted
                                          example: false
                                 sharedOrganizations:
                                    type: array
                                    description: List of organizations this release channel is shared with
                                    items:
                                       type: object
                                       properties:
                                          id:
                                             type: string
                                             description: Unique identifier of the organization
                                             example: "org_789"
                                          name:
                                             type: string
                                             description: Name of the organization
                                             example: "Example Org"
                     example:
                        data:
                           id: "rc_123"
                           name: "Stable"
                           type: "app"
                           packageName: "com.example.app"
                           targetVersion:
                              id: "av_123"
                              type: "managed"
                              configurationDeployments:
                                 { "config_123": 1, "config_456": 0 }
                              createdAt: 1645615777448
                              updatedAt: 1687352117203
                              versionCode: 83894522
                              versionName: "8.7.8.1206"
                              apkSize: 72633861
                              selfHosted: false
                           sharedOrganizations:
                              - id: "org_789"
                                name: "Example Org"
            "400":
               description: Release channel package name mismatch
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Release channel with id rc_123 does not match the provided package name com.example.app"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Release channel with id rc_123 does not match the provided package name com.example.app"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Release channel not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Release channel with id rc_123 not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Release channel with id rc_123 not found"
                        error: "ManageXR Error"
   /v1/apps/{packageName}/release-channels/{releaseChannelId}/unshare:
      post:
         summary: Unshare a release channel
         description: Unshare an app release channel with a client organization
         parameters:
            - name: packageName
              in: path
              required: true
              schema:
                 type: string
              description: The package name of the app
            - name: releaseChannelId
              in: path
              required: true
              schema:
                 type: string
              description: The unique identifier of the release channel
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        organizationIds:
                           type: array
                           items:
                              type: string
                           description: Array of organization IDs to unshare the release channel with
                           example: ["org_123", "org_456"]
                     required:
                        - organizationIds
                  example:
                     organizationIds: ["org_123", "org_456"]
         responses:
            "200":
               description: The updated release channel
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the release channel
                                    example: "rc_123"
                                 name:
                                    type: string
                                    description: Name of the release channel
                                    example: "Stable"
                                 type:
                                    type: string
                                    enum: [app, link, video]
                                    description: Type of the release channel
                                    example: "app"
                                 packageName:
                                    type: string
                                    description: Package name of the app
                                    example: "com.example.app"
                                 targetVersion:
                                    type: object
                                    description: The target app version for this release channel
                                    properties:
                                       id:
                                          type: string
                                          description: Unique identifier of the app version
                                          example: "av_123"
                                       type:
                                          type: string
                                          enum:
                                             [
                                                managed,
                                                shared,
                                                external,
                                                instant,
                                             ]
                                          description: Type of the app version
                                          example: "managed"
                                       configurationDeployments:
                                          type: object
                                          description: Map of configuration ID to device count using application
                                          example:
                                             {
                                                "config_123": 1,
                                                "config_456": 0,
                                             }
                                       createdAt:
                                          type: number
                                          description: Creation timestamp
                                          example: 1645615777448
                                       updatedAt:
                                          type: number
                                          description: Last update timestamp
                                          example: 1687352117203
                                       versionCode:
                                          type: number
                                          description: Version code of the app
                                          example: 83894522
                                       versionName:
                                          type: string
                                          description: Version name of the app
                                          example: "8.7.8.1206"
                                       apkSize:
                                          type: number
                                          description: Size of the APK file in bytes
                                          example: 72633861
                                       selfHosted:
                                          type: boolean
                                          description: Whether the app is self-hosted
                                          example: false
                                 sharedOrganizations:
                                    type: array
                                    description: List of organizations this release channel is shared with
                                    items:
                                       type: object
                                       properties:
                                          id:
                                             type: string
                                             description: Unique identifier of the organization
                                             example: "org_789"
                                          name:
                                             type: string
                                             description: Name of the organization
                                             example: "Example Org"
                     example:
                        data:
                           id: "rc_123"
                           name: "Stable"
                           type: "app"
                           packageName: "com.example.app"
                           targetVersion:
                              id: "av_123"
                              type: "managed"
                              configurationDeployments:
                                 { "config_123": 1, "config_456": 0 }
                              createdAt: 1645615777448
                              updatedAt: 1687352117203
                              versionCode: 83894522
                              versionName: "8.7.8.1206"
                              apkSize: 72633861
                              selfHosted: false
                           sharedOrganizations:
                              - id: "org_789"
                                name: "Example Org"
            "400":
               description: Release channel package name mismatch
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Release channel with id rc_123 does not match the provided package name com.example.app"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Release channel with id rc_123 does not match the provided package name com.example.app"
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Release channel not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 404
                           message:
                              type: string
                              example: "Release channel with id rc_123 not found"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 404
                        message: "Release channel with id rc_123 not found"
                        error: "ManageXR Error"
   ##################################################
   # V1‑Configurations
   ##################################################
   /v1/configurations/:
      get:
         summary: List configurations
         description: Retrieve all configurations.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of configurations
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1ConfigurationResponse"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
      post:
         summary: Create a configuration
         description: Create a new configuration. Creates a blank configuration with default settings and no content.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     required:
                        - name
                     properties:
                        name:
                           type: string
                           description: Name of the configuration
                     example:
                        name: "New Configuration A"
         responses:
            "200":
               description: The created configuration
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1ConfigurationResponse"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   /v1/configurations/duplicate:
      post:
         summary: Duplicate configuration
         description: |
            Creates a new configuration by cloning an existing one.

         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     required:
                        - name
                        - configurationId
                     properties:
                        name:
                           type: string
                           description: Name for the new configuration
                        configurationId:
                           type: string
                           description: ID of the configuration to duplicate
                  examples:
                     example-request:
                        summary: Duplicate a configuration
                        value:
                           name: "Client Config v2"
                           configurationId: "TY8ZiuJoxuy51fsSxXp0"
         responses:
            "201":
               description: Configuration duplicated successfully
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1ConfigurationResponse"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Source configuration not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "Configuration with id TY8ZiuJoxuy51fsSxXp0 not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "Configuration with id TY8ZiuJoxuy51fsSxXp0 not found"
                        error: "ManageXR Error"

   /v1/configurations/{id}:
      get:
         summary: Get a configuration
         description: Retrieve a configuration by id.
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the configuration
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: The requested configuration
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1ConfigurationResponse"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Configuration not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "Configuration with id sFidGmedeQofSBcvRcyn not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "Configuration with id sFidGmedeQofSBcvRcyn not found"
                        error: "ManageXR Error"

      patch:
         summary: Edit a configuration
         description: |
            Update an existing configuration to change the content deployed  
            (e.g., update app versions, add/remove apps, videos, and WebXR links).
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the configuration
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: Updated name for the configuration
                           example: "Client Configuration v2"
                        vrContent:
                           $ref: "#/components/schemas/V1ConfigurationVrContentPatch"
                           description: Updated set of VR content on the configuration. Content will appear on the Home Screen in the order it appears in the vrContent array.
                        kioskVrContent:
                           description: |
                              Set the App or video to kiosk devices into.

                              Requirements: 
                              - The `deviceExperience` field must also be set to `KIOSK` or `KIOSK_VIDEO`
                              - The App or Video must be included in the configurations `vrContent` already (or in this request)
                           $ref: "#/components/schemas/V1ConfigurationKioskContentPatch"

                        deviceExperienceMode:
                           type: string
                           description: |
                              Device experience 

                              KIOSK is Kiosk App. Options vary by device type. See supported device information [here](https://help.managexr.com/en/articles/5281345-supported-devices).
                           enum: [HOME_SCREEN, KIOSK, KIOSK_VIDEO, DEFAULT]
                           example: HOME_SCREEN
                        kioskModeStrictness:
                           type: string
                           description: |
                              Kiosk mode strictness level.

                              **DEFAULT** - Recommended setting. Standard kiosk experience on ManageXR. Allows access to Meta quick settings menu.

                              **KIOSK_APP** - Forces user to only remain in kiosk app and not access anything else on the device, including quick settings or other system apps. This may impact your ability to cast the device using native casting.
                           enum: [DEFAULT, KIOSK_APP]
                           example: DEFAULT
                        confirmMetaDeviceModeChange:
                           type: boolean
                           description: Only required if deviceExperience change impacts Meta Horizon managed services [device mode](https://help.managexr.com/en/articles/10509502-meta-horizon-device-modes#h_8349d611b6). Supplying the flag confirms that you understand [the risks](https://help.managexr.com/en/articles/10509502-meta-horizon-device-modes#h_8349d611b6) and requirements of the mode change._
                           example: false
                        wifiNetworkIds:
                           type: array
                           description: Unique identifiers of wi-fi networks to deploy on the configuration
                           items:
                              type: string
                           exmaple: ["1390KJDL139PJD", "KAFJ39UT124P98"]
                        priorityWifiNetworkId:
                           type: string
                           nullable: true
                           description:
                              The id of the wi-fi network to set as the priority network. A device will always connect to the priority network over other networks if it is in range. |
                              Set to `null` to clear the priority.
                           example: 1390KJDL139PJD
                        files:
                           $ref: "#/components/schemas/V1BundledFileEditDto"
                        timeZone:
                           type: string
                           description: |
                              Time zone for the configuration. Can be set to 'UNMANAGED', 'AUTO', or a specific time zone ID.

                              Valid timeZoneIds include:
                              - Pacific/Midway
                              - Pacific/Honolulu
                              - America/Anchorage
                              - America/Los_Angeles
                              - America/Tijuana
                              - America/Phoenix
                              - America/Chihuahua
                              - America/Denver
                              - America/Costa_Rica
                              - America/Chicago
                              - America/Mexico_City
                              - America/Regina
                              - America/Bogota
                              - America/New_York
                              - America/Caracas
                              - America/Barbados
                              - America/Halifax
                              - America/Manaus
                              - America/Santiago
                              - America/St_Johns
                              - America/Sao_Paulo
                              - America/Argentina/Buenos_Aires
                              - America/Godthab
                              - America/Montevideo
                              - Atlantic/South_Georgia
                              - Atlantic/Azores
                              - Atlantic/Cape_Verde
                              - Africa/Casablanca
                              - Europe/London
                              - Europe/Amsterdam
                              - Europe/Belgrade
                              - Europe/Brussels
                              - Europe/Sarajevo
                              - Africa/Windhoek
                              - Africa/Brazzaville
                              - Asia/Amman
                              - Europe/Athens
                              - Asia/Beirut
                              - Africa/Cairo
                              - Europe/Helsinki
                              - Asia/Jerusalem
                              - Europe/Minsk
                              - Africa/Harare
                              - Asia/Baghdad
                              - Europe/Moscow
                              - Asia/Kuwait
                              - Africa/Nairobi
                              - Asia/Tehran
                              - Asia/Baku
                              - Asia/Tbilisi
                              - Asia/Yerevan
                              - Asia/Dubai
                              - Asia/Kabul
                              - Asia/Karachi
                              - Asia/Oral
                              - Asia/Yekaterinburg
                              - Asia/Calcutta
                              - Asia/Colombo
                              - Asia/Katmandu
                              - Asia/Almaty
                              - Asia/Rangoon
                              - Asia/Krasnoyarsk
                              - Asia/Bangkok
                              - Asia/Jakarta
                              - Asia/Shanghai
                              - Asia/Hong_Kong
                              - Asia/Irkutsk
                              - Asia/Kuala_Lumpur
                              - Australia/Perth
                              - Asia/Taipei
                              - Asia/Seoul
                              - Asia/Tokyo
                              - Asia/Yakutsk
                              - Australia/Adelaide
                              - Australia/Darwin
                              - Australia/Brisbane
                              - Australia/Hobart
                              - Australia/Sydney
                              - Pacific/Majuro
                              - Asia/Vladivostok
                              - Pacific/Guam
                              - Asia/Magadan
                              - Pacific/Auckland
                              - Pacific/Fiji
                              - Pacific/Tongatapu
                              - Etc/GMT+12
                              - Etc/GMT+11
                              - Etc/GMT+10
                              - Etc/GMT+9
                              - Etc/GMT+8
                              - Etc/GMT+7
                              - Etc/GMT+6
                              - Etc/GMT+5
                              - Etc/GMT+4
                              - Etc/GMT+3
                              - Etc/GMT+2
                              - Etc/GMT+1
                              - Etc/GMT
                              - Etc/GMT-1
                              - Etc/GMT-2
                              - Etc/GMT-3
                              - Etc/GMT-4
                              - Etc/GMT-5
                              - Etc/GMT-6
                              - Etc/GMT-7
                              - Etc/GMT-8
                              - Etc/GMT-9
                              - Etc/GMT-10
                              - Etc/GMT-11
                              - Etc/GMT-12
                              - Etc/GMT-13
                              - Etc/GMT-14

                              Time zones with the Etc/GMT prefix are the equivalent of UTC time zones. Only the ID part needs to be supplied (e.g., "America/New_York", not the full name).
                           enum: [UNMANAGED, AUTO, timeZoneId]
                           example: "America/New_York"

                  example:
                     name: "Client Configuration v2"
                     vrContent:
                        - type: app
                          id:
                             packageName: "com.my.customApp"
                             releaseChannel: "prod"
                        - type: video
                          id: "KSJ34KHDA12MR"
                        - type: app
                          id:
                             packageName: "com.my.test1"
                             version: "latest"
                        - type: app
                          id:
                             packageName: "com.my.test1"
                             version:
                                versionCode: 1
                                versionName: "1.0"
                     wifiNetworkIds: ["1390KJDL139PJD", "KAFJ39UT124P98"]
         responses:
            "200":
               description: The updated configuration
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              $ref: "#/components/schemas/V1ConfigurationResponse"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Configuration not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "Configuration with id sFidGmedeQofSBcvRcyn not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "Configuration with id sFidGmedeQofSBcvRcyn not found"
                        error: "ManageXR Error"

      delete:
         summary: Delete a configuration
         description: |
            Removes a configuration from ManageXR.  
            You cannot delete configurations that are currently applied to devices.
         parameters:
            - name: id
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the configuration
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: Configuration deleted successfully
            "400":
               description: Configuration is applied to devices
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 400 }
                           message:
                              {
                                 type: string,
                                 example: "Cannot delete a configuration that is currently applied to devices. This configuration is referenced by 2 devices.",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 400
                        message: "Cannot delete a configuration that is currently applied to devices. This configuration is referenced by 2 devices."
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
            "404":
               description: Configuration not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 404 }
                           message:
                              {
                                 type: string,
                                 example: "Configuration with id sFidGmedeQofSBcvRcyn not found",
                              }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 404
                        message: "Configuration with id sFidGmedeQofSBcvRcyn not found"
                        error: "ManageXR Error"
   ##################################################
   # Tags
   ##################################################
   /v1/tags/:
      post:
         summary: Create tag
         description: Create a new tag
         parameters:
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: Name of the tag
                           example: "History"
                     required:
                        - name
                  example:
                     name: "History"
         responses:
            "200":
               description: The created tag
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the tag
                                    example: "sFidGmedeQofSBcvRcyn"
                                 name:
                                    type: string
                                    description: Name of the tag
                                    example: "History"
                     example:
                        data:
                           id: "sFidGmedeQofSBcvRcyn"
                           name: "History"
            "400":
               description: Tag name already exists
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Tag with name History already exists"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Tag with name History already exists"
                        error: "ManageXR Error"
   /v1/tags/{tagId}:
      patch:
         summary: Edit tag
         description: Update an existing tag's name
         parameters:
            - name: tagId
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the tag
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           description: New name for the tag
                           example: "World History"
                     required:
                        - name
                  example:
                     name: "World History"
         responses:
            "200":
               description: The updated tag
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              properties:
                                 id:
                                    type: string
                                    description: Unique identifier of the tag
                                    example: "sFidGmedeQofSBcvRcyn"
                                 name:
                                    type: string
                                    description: Name of the tag
                                    example: "World History"
                     example:
                        data:
                           id: "sFidGmedeQofSBcvRcyn"
                           name: "World History"
            "400":
               description: Tag name already exists
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Tag with name World History already exists"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Tag with name World History already exists"
                        error: "ManageXR Error"
            "404":
               description: Tag not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           message:
                              type: string
                              example: "Tag with id sFidGmedeQofSBcvRcyn not found"
      delete:
         summary: Delete tag
         description: Delete a tag
         parameters:
            - name: tagId
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the tag
            - name: organizationId
              in: query
              required: false
              schema:
                 type: string
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: Tag successfully deleted
            "404":
               description: Tag not found
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           message:
                              type: string
                              example: "Tag with id sFidGmedeQofSBcvRcyn not found"
   ##################################################
   # Wi-Fi Networks
   ##################################################
   /v1/wifi-networks:
      get:
         summary: List Wi‑Fi networks
         description: Returns all Wi‑Fi networks stored in the organization’s library.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of Wi-Fi networks
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1WifiNetwork"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
      post:
         summary: Create a Wi-Fi Network
         description: |
            Add a new Open, WPA2 or WPA2-Enterprise Wi-Fi network to your Library
         parameters:
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     description: Wi-Fi network credentials and information
                     $ref: "#/components/schemas/CreateWifiNetworkDto"
         responses:
            "200":
               description: The created wi-fi network
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: object
                              $ref: "#/components/schemas/V1WifiNetwork"
            "400":
               description: Invalid request
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 400
                           message:
                              type: string
                              example: "Password must be set for this network type."
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 400
                        message: "Password must be set for this network type."
                        error: "ManageXR Error"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode:
                              type: number
                              example: 403
                           message:
                              type: string
                              example: "Forbidden"
                           error:
                              type: string
                              example: "ManageXR Error"
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"

   ##################################################
   # Videos
   ##################################################
   /v1/videos:
      get:
         summary: List Videos
         description: Returns all videos stored in the organization’s library.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of videos
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1ContentVideo"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"
   ##################################################
   # Links
   ##################################################
   /v1/links:
      get:
         summary: List WebXR links
         description: Returns all WebXR links stored in the organization’s library.
         parameters:
            - name: organizationId
              in: query
              required: false
              schema: { type: string }
              description: |
                 Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. 

                 Defaults to the organizationId associated with the API key.
         responses:
            "200":
               description: A list of WebXR links
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           data:
                              type: array
                              items:
                                 $ref: "#/components/schemas/V1ContentLink"
            "403":
               description: Forbidden
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           statusCode: { type: number, example: 403 }
                           message: { type: string, example: "Forbidden" }
                           error: { type: string, example: "ManageXR Error" }
                     example:
                        statusCode: 403
                        message: "Forbidden"
                        error: "ManageXR Error"

   # v0 Endpoints:
   ##################################################
   # Devices
   ##################################################
   /organizations/{orgId}/devices:
      get:
         summary: List Devices
         description: Retrieve a list of devices
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
            - name: names
              in: query
              required: false
              schema:
                 type: string
              description: Query by device name. Allows partial matching. Separate multiple name parameters by comma.
            - name: serials
              in: query
              required: false
              schema:
                 type: string
              description: Query by device serial. Allows partial matching. Separate multiple serial parameters by comma.
            - name: configurations
              in: query
              required: false
              schema:
                 type: string
              description: Query by configuration unique identifier. Separate multiple configuration id parameters by comma.
            - name: tags
              in: query
              required: false
              schema:
                 type: string
              description: Query by tag unique identifier. Separate multiple tag id parameters by comma.
            - name: models
              in: query
              required: false
              schema:
                 type: string
              description: Query by model name. Separate multiple model parameters by comma.
            - name: manufacturers
              in: query
              required: false
              schema:
                 type: string
              description: Query by manufacturer name. Separate multiple manufacturer parameters by comma.
            - name: firmwareVersions
              in: query
              required: false
              schema:
                 type: string
              description: Query by firmware version. Separate multiple firmware version parameters by comma.
            - name: filters
              in: query
              required: false
              schema:
                 type: string
                 enum:
                    - online
                    - offline
                    - upToDate
                    - outOfDate
                    - updateError
                    - updating
                    - paused
                    - lowBattery
                    - activeToday
                    - activeWeek
                    - activeMonth
                    - activeOther
                    - factoryResetPending
                    - factoryReset
              description: Query by filter.
         responses:
            "200":
               description: A list of devices
               content:
                  application/json:
                     schema:
                        type: array
                        items:
                           oneOf:
                              - $ref: "#/components/schemas/V1Device"
   /organizations/{orgId}/devices/set-pause-updates:
      post:
         summary: Set pause updates for devices
         description: |
            Pause or resume configuration updates for devices.

            Pausing configuration updates stops a device from syncing with its latest Configuration. User-initiated changes to Configurations and ManageXR-initiated updates to the ManageXR Admin App and Home Screen will not propagate to devices with updates paused.
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        deviceIds:
                           type: array
                           items:
                              type: string
                           description: Array of device IDs (serial numbers) to update.
                        pauseUpdates:
                           type: boolean
                           description: Whether to pause (true) or resume (false) configuration updates.
                     required:
                        - deviceIds
                        - pauseUpdates
                  examples:
                     example-pause:
                        summary: Pause updates for devices
                        value:
                           deviceIds:
                              - 2G0YC1ZF630NZA
                              - PA7950RGGC06043
                           pauseUpdates: true
                     example-resume:
                        summary: Resume updates for devices
                        value:
                           deviceIds:
                              - 2G0YC1ZF630NZA
                              - PA7950RGGC06043
                           pauseUpdates: false
         responses:
            "201":
               description: Success
   /organizations/{orgId}/devices/{deviceId}/command:
      post:
         summary: Send command
         description: |
            Send command to a specific device

            <small>Available Commands: Launch App, Play/Pause Video, Launch Web Url, Disable/Enable Kiosk, Restart, Power Off, Set Volume, Set Brightness, Uninstall App, Sync, Enable/Disable Tutorial Mode</small>
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
            - name: deviceId
              in: path
              required: true
              schema:
                 type: string
              description: The ID (serial number) of the device.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     oneOf:
                        - title: Launch App
                          type: object
                          properties:
                             action:
                                type: string
                                required: true
                                description: Launch an application on the device.
                                enum:
                                   - LAUNCH_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      required: true
                                      description: The package name of the app to be launched
                                      example: "com.myapp.quest"
                                   launchParams:
                                      type: object
                                      description: |
                                         (Optional) Additional custom launch parameters

                                         e.g., { userId: 'ABC123', booleanValue: true, arrayValue: [1.23, 4.56], mapValue: { key: 'more stuff' }}
                                      example:
                                         userId: "ABC123"
                                         booleanValue: true
                                         floatValue: 100.29
                                         arrayValue: [1.23, 4.56]
                                         mapValue: { key: "more stuff" }
                                      required: false
                        - title: Play / Pause Video
                          type: object
                          properties:
                             action:
                                type: string
                                description: Play or pause video on the device.
                                enum:
                                   - PLAY_VIDEO
                                   - PAUSE_VIDEO
                                example: PLAY_VIDEO
                             data:
                                type: object
                                properties:
                                   videoId:
                                      type: string
                                      description: |
                                         The id of the video to play or pause. 

                                         To find a videoId, go to the video in your VR Content library on the Web Console and retrieve it from the url parameters (e.g. console.managexr.com/o/{orgId}/vr-content/edit/video/**FeWVcu7Rq4X3rmwGZGM6**).
                                   playFromBeginning:
                                      type: boolean
                                      description: (Optional) Plays video from the beginning. If falsy and the video is already open, play resumes from position.
                        - title: Launch Web Url
                          type: object
                          properties:
                             action:
                                type: string
                                description: Launch a specific webxr link on the device. Requires the data field to be populated (see below)
                                enum:
                                   - LAUNCH_WEB_URL
                                example: LAUNCH_WEB_URL
                             data:
                                type: object
                                properties:
                                   url:
                                      type: string
                                      description: The url of the webxr link to launch
                        - title: Disable / Enable Kiosk Mode
                          type: object
                          properties:
                             action:
                                type: string
                                description: |
                                   Override the device experience set on the Configuration. 

                                   `DISABLE_KIOSK` - Disable Kiosk Mode / ManageXR Home Screen on the device. Grants users full access to the default system menus. Sets `kioskModeOverride` flag on device to `true`.

                                   `ENABLE_KIOSK` - Re-Enable Kiosk Mode / ManageXR Home Screen on the device. Sets `kioskModeOverride` flag on device to `false`.

                                   _Note_, if the Configuration applied to a device uses Default Device Menus, the kioskModeOverride flag is a no-op.
                                enum:
                                   - DISABLE_KIOSK
                                   - ENABLE_KIOSK
                                example: DISABLE_KIOSK
                        - title: Restart
                          type: object
                          properties:
                             action:
                                type: string
                                description: Reboot the device.
                                enum:
                                   - RESTART
                                example: RESTART
                        - title: Power OFF
                          type: object
                          properties:
                             action:
                                type: string
                                description: Remotely turn off device. Supported on Meta Quest v77+ enrolled through MHMS, Pico Neo 3s PUI 5+, Pico 4 Ultra Enterprise devices.
                                enum:
                                   - POWER_OFF
                                example: POWER_OFF
                        - title: Set Volume
                          type: object
                          properties:
                             action:
                                type: string
                                description: Set volume on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_VOLUME
                                example: SET_VOLUME
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The volume level to set. Choose a value between 0 and 100.
                        - title: Set Brightness
                          type: object
                          properties:
                             action:
                                type: string
                                description: Set display brightness on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_BRIGHTNESS
                                example: SET_BRIGHTNESS
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The display brightness level to set. Choose a value between 0 and 100.
                        - title: Uninstall App
                          type: object
                          properties:
                             action:
                                type: string
                                description: |
                                   Uninstall an application on the device. 

                                   Cannot uninstall system apps. If you uninstall an app that is still on a devices's configuration, it will automatically re-download the next time the device syncs.
                                enum:
                                   - UNINSTALL_APP
                                example: UNINSTALL_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to uninstall
                        - title: Restart App
                          type: object
                          properties:
                             action:
                                type: string
                                description: Restart an app
                                enum:
                                   - RESTART_APP
                                example: RESTART_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to restart
                        - title: Sync
                          type: object
                          properties:
                             action:
                                type: string
                                description: Force device to check in with ManageXR. Online devices sync every 15 minutes or immediately when configuration changes are made.
                                enum:
                                   - SYNC
                                example: SYNC
                        - title: Enable / Disable Tutorial Mode
                          type: object
                          properties:
                             action:
                                type: string
                                description: When Tutorial Mode in enabled, the device launches into its tutorial app on boot. Set the tutorial app in Configuration > Device Settings.
                                enum:
                                   - ENABLE_TUTORIAL_MODE
                                   - DISABLE_TUTORIAL_MODE
                                example: ENABLE_TUTORIAL_MODE
                  examples:
                     example-sync:
                        summary: Sync command
                        value:
                           action: SYNC
                     example-launch_app:
                        summary: Launch App command
                        value:
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                     example-launch_app_with_params:
                        summary: Launch app with parameters
                        value:
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                              launchParams:
                                 userId: AX3EIUf89
                                 booleanValue: true
                                 floatValue: 100.29
                                 arrayValue: [1.23, 4.56]
                                 mapValue:
                                    key: value
                     example-launch_webxr:
                        summary: Launch webxr link
                        value:
                           action: LAUNCH_WEB_URL
                           data:
                              url: https://google.com
         responses:
            "200":
               description: Success
   /organizations/{orgId}/devices/batch-command:
      post:
         summary: Send a command to multiple devices at once
         description: |
            Send a command to multiple devices at once

            <small>Available Commands: Launch App, Play/Pause Video, Launch Web Url, Disable/Enable Kiosk, Restart, Power Off, Set Volume, Set Brightness, Uninstall App, Sync, Enable/Disable Tutorial Mode </small>
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     oneOf:
                        - title: Launch App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                required: true
                                description: Launch an application on the devices
                                enum:
                                   - LAUNCH_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      required: true
                                      description: The package name of the app to be launched
                                      example: "com.myapp.quest"
                                   launchParams:
                                      type: object
                                      description: |
                                         (Optional) Additional custom launch parameters

                                         e.g., { userId: 'ABC123', booleanValue: true, arrayValue: [1.23, 4.56], mapValue: { key: 'more stuff' }}
                                      example:
                                         userId: "ABC123"
                                         booleanValue: true
                                         floatValue: 100.29
                                         arrayValue: [1.23, 4.56]
                                         mapValue: { key: "more stuff" }
                                      required: false
                        - title: Play / Pause Video
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Play or pause video on the devices
                                enum:
                                   - PLAY_VIDEO
                                   - PAUSE_VIDEO
                                example: PLAY_VIDEO
                             data:
                                type: object
                                properties:
                                   videoId:
                                      type: string
                                      description: |
                                         The id of the video to play or pause. 

                                         To find a videoId, go to the video in your VR Content library on the Web Console and retrieve it from the url parameters (e.g. console.managexr.com/o/{orgId}/vr-content/edit/video/**FeWVcu7Rq4X3rmwGZGM6**).
                                   playFromBeginning:
                                      type: boolean
                                      description: (Optional) Plays video from the beginning. If falsy and the video is already open, play resumes from position.
                        - title: Launch Web Url
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Launch a specific WebXR link on the devices. Requires the data field to be populated (see below)
                                enum:
                                   - LAUNCH_WEB_URL
                                example: LAUNCH_WEB_URL
                             data:
                                type: object
                                properties:
                                   url:
                                      type: string
                                      description: The url of the webxr link to launch
                        - title: Disable / Enable Kiosk Mode
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: |
                                   Override the device experience set on the Configuration. 

                                   `DISABLE_KIOSK` - Disable Kiosk Mode / ManageXR Home Screen on the devices. Grants users full access to the default system menus. Sets `kioskModeOverride` flag on devices to `true`.

                                   `ENABLE_KIOSK` - Re-Enable Kiosk Mode / ManageXR Home Screen on the devices. Sets `kioskModeOverride` flag on devices to `false`.

                                   _Note_, if the Configuration applied to a device uses Default Device Menus, the kioskModeOverride flag is a no-op.
                                enum:
                                   - DISABLE_KIOSK
                                   - ENABLE_KIOSK
                                example: DISABLE_KIOSK
                        - title: Restart
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Reboot the devices
                                enum:
                                   - RESTART
                                example: RESTART
                        - title: Power OFF
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Remotely turn off device. Supported on Meta Quest v77+ enrolled through MHMS, Pico Neo 3s PUI 5+, Pico 4 Ultra Enterprise devices.
                                enum:
                                   - POWER_OFF
                                example: POWER_OFF
                        - title: Set Volume
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Set volume on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_VOLUME
                                example: SET_VOLUME
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The volume level to set. Choose a value between 0 and 100.
                        - title: Set Brightness
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Set brightness on device. Supply a level between 0 and 100.
                                enum:
                                   - SET_BRIGHTNESS
                                example: SET_BRIGHTNESS
                             data:
                                type: object
                                properties:
                                   level:
                                      type: number
                                      description: The brightness level to set. Choose a value between 0 and 100.
                        - title: Uninstall App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: |
                                   Uninstall an application on the devices. 

                                   Cannot uninstall system apps. If you uninstall an app that is still on a devices's configuration, it will automatically re-download the next time the device syncs.
                                enum:
                                   - UNINSTALL_APP
                                example: LAUNCH_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to uninstall
                        - title: Restart App
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Restart an app
                                enum:
                                   - RESTART_APP
                                example: RESTART_APP
                             data:
                                type: object
                                properties:
                                   packageName:
                                      type: string
                                      description: The package name of the app to restart
                        - title: Sync
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: Force devices to check in with ManageXR. Online devices sync every 15 minutes or immediately when configuration changes are made.
                                enum:
                                   - SYNC
                                example: SYNC
                        - title: Enable / Disable Tutorial Mode
                          type: object
                          properties:
                             deviceIds:
                                type: array
                                items:
                                   type: string
                                description: List of unique identifiers (serial numbers) of devices
                             action:
                                type: string
                                description: When Tutorial Mode in enabled, the devices launch into their tutorial app on boot. Set the tutorial app in Configuration > Device Settings.
                                enum:
                                   - ENABLE_TUTORIAL_MODE
                                   - DISABLE_TUTORIAL_MODE
                                example: ENABLE_TUTORIAL_MODE
                  examples:
                     example-sync:
                        summary: Sync command
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: SYNC
                     example-launch_app:
                        summary: Launch App command
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                     example-launch_app_with_params:
                        summary: Launch app with parameters
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_APP
                           data:
                              packageName: com.example.app
                              launchParams:
                                 userId: AX3EIUf89
                                 booleanValue: true
                                 floatValue: 100.29
                                 arrayValue: [1.23, 4.56]
                                 mapValue:
                                    key: value
                     example-launch_webxr:
                        summary: Launch webxr link
                        value:
                           deviceIds:
                              ["fJlJrjEL08UkhSLRRryd", "GrCQfwI4373WFqzVjguI"]
                           action: LAUNCH_WEB_URL
                           data:
                              url: https://google.com
         responses:
            "200":
               description: Success
   /organizations/{orgId}/devices/{deviceId}:
      patch:
         summary: Edit Device
         description: Update device metadata and configuration
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
            - name: deviceId
              in: path
              required: true
              schema:
                 type: string
              description: The ID (serial number) of the device.
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     properties:
                        name:
                           type: string
                           required: false
                           description: Name of device
                        configurationId:
                           type: string
                           required: false
                           description: ID of configuration applied to device
                        notes:
                           type: string
                           required: false
                           description: Device notes
                        tagIds:
                           type: array
                           required: false
                           description: Array of tag ids to apply to device. Replaces any existing tags
                           items:
                              type: string
                              example: "k7FQPc24o4Y7M0FK"
                              description: The id of a tag you want to set on the device
                  examples:
                     example-update:
                        summary: Update device name, configuration, and notes
                        value:
                           name: Taylor Quest 3
                           configurationId: yw5VSRLRoRDhNRhm0Nl
                           notes: At conference
         responses:
            "200":
               description: Success
      get:
         summary: Get device
         description: Retrieve a device by id (serial number)
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
            - name: deviceId
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier (serial number) of the device
         responses:
            "200":
               description: A device object
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           serial:
                              type: string
                              example: 2G0YC1ZF630NZA
                              description: The serial number of the device. Also serves as the ID on ManageXR.
                           name:
                              type: string
                              example: Device_0024
                              description: The name given to the device on ManageXR
                           mac:
                              type: string
                              example: CE:AF:07:47:E0:AE
                              description: Device MAC address
                           model:
                              type: string
                              example: Quest 3
                              description: Device model
                           manufacturer:
                              type: string
                              example: Oculus
                              description: Device manufacturer. Note, Meta devices report as Oculus
                           notes:
                              type: string
                              example: With Taylor L
                              description: The notes given to a device on ManageXR
                           batteryLevel:
                              type: number
                              example: 34
                              description: The battery level of the device
                           batteryIsCharging:
                              type: boolean
                              example: true
                              description: True if the device is charging
                           online:
                              type: boolean
                              example: true
                              description: True if the device is online
                           osVersion:
                              type: string
                              example: 12
                              description: The Android operating system version
                           outOfDate:
                              type: boolean
                              example: false
                              description: True if device is not compliant with its configuration on ManageXR
                           pauseUpdates:
                              type: boolean
                              example: false
                              description: True if configuration updates are paused for device. Pausing configuration updates stops a device from syncing with its latest Configuration. User-initiated changes to Configurations and ManageXR-initiated updates to the ManageXR Admin App and Home Screen will not propagate to devices with updates paused.
                           registerDate:
                              type: string
                              format: date-time
                              example: Tue, 27 Feb 2024 07:28:03 GMT
                              description: Date the device was registered on ManageXR
                           updating:
                              type: boolean
                              example: false
                              description: True if the device is currently downloading content or firmware
                           factoryResetStatus:
                              type: string
                              enum:
                                 - QUEUED
                                 - COMPLETE
                                 - null
                              example: null
                              description: This status is set when an admin sends a factory reset command to a device. Null if no factory reset command has been sent.
                           firmwareVersion:
                              type: string
                              example: 65.0.0.546.341
                              description: Device firmware version
                           configuration:
                              type: object
                              properties:
                                 name:
                                    type: string
                                    description: "Configuration name"
                                 id:
                                    type: string
                                    description: "Configuration id"
                              example:
                                 name: Test Configuration
                                 id: OZ04csIYkA0EArkeu1vX
                              description: The configuration applied to the device on ManageXR
                           tags:
                              type: array
                              example:
                                 [{ id: sFidGmedeQofSBcvRcyn, name: History }]
                              description: The tags applied to the device on ManageXR. Null if device has no tags.
                           tutorialModeEnabled:
                              type: boolean
                              example: false
                              description: True if device is in Tutorial Mode
                           kioskModeOverride:
                              type: boolean
                              example: false
                              description: True if device has Kiosk Mode/ManageXR Home Screen disabled. When true, the device is not locked into the ManageXR Home Screen or Kiosk App and users have full access to the native system menus. [Learn more](https://help.managexr.com/en/articles/5416931-temporarily-disable-kiosk-mode-home-screen)
                           lastSync:
                              type: string
                              format: date-time
                              example: Tue, 18 Jun 2024 21:46:34 GMT
                              description: The last time the device checked in with ManageXR. Online devices check in every 15 minutes.
                           ram:
                              type: object
                              properties:
                                 available:
                                    type: number
                                    description: Available RAM in bytes
                                 total:
                                    type: number
                                    description: Total RAM in bytes
                              example:
                                 available: 3704000512
                                 total: 8108634112
                              description: Device RAM in bytes
                           location:
                              type: object
                              properties:
                                 city:
                                    type: string
                                 region:
                                    type: string
                                 country:
                                    type: string
                                 continent:
                                    type: string
                                 timeZone:
                                    type: string
                                 latitude:
                                    type: number
                                 longitude:
                                    type: number
                              example:
                                 city: San Francisco
                                 region: California
                                 country: United States
                                 continent: North America
                                 timeZone: America/Los_Angeles
                                 latitude: 37
                                 longitude: -122
                              description: Device location as determined by its IP address and provided by ipstack.com
                           connectedWifiNetwork:
                              type: object
                              properties:
                                 ssid:
                                    type: string
                                    description: The ssid of the last connected wifi network
                              example:
                                 ssid: TheElectricCity
                              description: Information about the last connected wifi network
                           storage:
                              type: object
                              properties:
                                 available:
                                    type: number
                              example:
                                 available: 107079929856
                              description: The available storage on the device in bytes
   ##################################################
   # Configurations
   ##################################################
   /organizations/{orgId}/configurations/{configurationId}:
      get:
         summary: Get configuration
         description: Retrieve a configuration by id
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
            - name: configurationId
              in: path
              required: true
              schema:
                 type: string
              description: Unique identifier of the configuration
         responses:
            "200":
               description: A configuration object
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           id:
                              type: string
                              example: 6qwM6FzJE4o708iqTpWc
                              description: Unique identifier of the configuration
                           name:
                              type: string
                              example: Trial
                              description: Name of the configuration
                           registrationCode:
                              type: string
                              example: f7GbHvH
                              description: Configuration code (formerly known as Registration Code) for the configuration. [Learn More](https://help.managexr.com/en/articles/5345978-register-a-device-using-a-registration-code)
                           deviceCount:
                              type: number
                              example: 15
                              description: Number of devices using the configuration
                           deviceExperience:
                              type: string
                              enum:
                                 - HOME_SCREEN
                                 - KIOSK
                                 - DEFAULT
                              description: Device experience set on the configuration
                           apps:
                              type: array
                              description: (Optional) List of all apps deployed on the configuration
                              required: false
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       example: 01b8e51a-15d3-2sd3-a0d8-4c13ff633413
                                       description: Unique identifier of the app
                                    title:
                                       type: string
                                       example: "Example App"
                                       description: Title of the app
                                    packageName:
                                       type: string
                                       example: "com.example.app"
                                       description: Package name of the app
                                    description:
                                       type: string
                                       example: "Quest version of my example app"
                                       description: Description of the app
                                    versionCode:
                                       type: number
                                       example: 42
                                       description: Numeric code of the app version
                                    versionName:
                                       type: string
                                       example: "1.0.0"
                                       description: Name of the app version
                                    versionLabel:
                                       type: string
                                       example: "Release"
                                       description: Label applied to the app version
                                    apkSize:
                                       type: number
                                       example: 1024
                                       description: Size of the APK file for this app version in bytes
                                    obbSize:
                                       type: number
                                       example: 1024
                                       description: (Optional) Size of the OBB file for this app version in bytes
                                       required: false
                                    categories:
                                       type: array
                                       items:
                                          type: string
                                       example: ["Onboarding", "Safety"]
                                       description: (Optional) List of Home Screen categories assigned to the app on ManageXR
                                       required: false
                                    hidden:
                                       type: boolean
                                       example: true
                                       description: (Optional) True if the app is hidden on the Home Screen. [Learn More](https://help.managexr.com/en/articles/8353693-how-to-hide-vr-content-from-the-home-screen)
                                    forceInstall:
                                       type: boolean
                                       example: false
                                       description: (Optional) True if Force Install is enabled for the app on this configuration. When true, app updates will uninstall the current version of the app on device before installing the next version. [Learn More](https://help.managexr.com/en/articles/5274045-deploying-applications#h_ddb1b059c3)
                                       required: false
                                    autoGrantPermissions:
                                       type: boolean
                                       example: true
                                       description: (Optional) True if Automatically Grant Permissions is enabled for the app on this configuration. When true, the device automatically grants certain device permissions that the app requests. [Learn More](https://help.managexr.com/en/articles/5274045-deploying-applications#h_ddb1b059c3)
                                    expirationTimestamp:
                                       type: number
                                       example: 1710566400
                                       description: (Optional) Expiration date of the shared app. Time in millis since 1970. [Learn More](https://help.managexr.com/en/articles/8562977-app-sharing-governance-set-expiration-dates-and-device-limits#h_7e9d3049df)
                                       required: false
                                    expirationBehavior:
                                       type: string
                                       enum:
                                          - NONE
                                          - DISABLE_APP
                                          - DELETE_APP
                                       example: DISABLE_APP
                                       description: (Optional) Expiration behavior of the shared app when `expirationTimestamp` is reached. [Learn More](https://help.managexr.com/en/articles/8562977-app-sharing-governance-set-expiration-dates-and-device-limits#h_371c2d0566)
                                       required: false
                           videos:
                              type: array
                              description: (Optional) List of all videos deployed on the configuration
                              required: false
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       example: 2656f354-9723-43f5-9165-f4b2a8662ab0
                                       description: Unique identifier of the video
                                    title:
                                       type: string
                                       example: "Example Video"
                                       description: Title of the video
                                    videoType:
                                       type: string
                                       enum:
                                          - _360
                                          - _180
                                          - _2D
                                       example: _360
                                       description: Type of video
                                    description:
                                       type: string
                                       example: "5 minute video of Patagonia"
                                       description: Description of the video
                                    size:
                                       type: number
                                       example: 1024
                                       description: Size of the video in bytes
                                    categories:
                                       type: array
                                       items:
                                          type: string
                                       example: ["Field Trips", "South America"]
                                       description: (Optional) List of Home Screen categories assigned to the app on ManageXR
                                    hidden:
                                       type: boolean
                                       example: false
                                       description: (Optional) True if the video is hidden on the Home Screen. [Learn More](https://help.managexr.com/en/articles/8353693-how-to-hide-vr-content-from-the-home-screen)
                           webxrLinks:
                              type: array
                              description: (Optional) List of WebXR Links deployed on the configuration
                              required: false
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       example: 1Gvlpc3JVGcynBrWSJwI
                                       description: Unique identifier of the WebXR link
                                    url:
                                       type: string
                                       example: http://www.thechinaguide.com/destination/great-wall-of-china
                                       description: Url of the WebXR link
                                    title:
                                       type: string
                                       example: "Great wall of China"
                                       description: Title of the WebXR link
                                    description:
                                       type: string
                                       example: "A grand tour of the great wall of China, from the comfort of your seat."
                                       description: Description of the WebXR link
                                    categories:
                                       type: array
                                       items:
                                          type: string
                                       example: ["Field Trips", "Asia"]
                                       description: (Optional) List of Home Screen categories assigned to the WebXR link on ManageXR
                                    hidden:
                                       type: boolean
                                       example: true
                                       description: (Optional) True if the WebXR Link is hidden on the Home Screen. [Learn More](https://help.managexr.com/en/articles/8353693-how-to-hide-vr-content-from-the-home-screen)
                           files:
                              type: array
                              description: (Optional) List of files deployed on the configuration
                              required: false
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       example: 0uZN2kuoQhcZJglgVNTc
                                       description: Unique identifier of the file
                                    path:
                                       type: string
                                       example: /foo/bar/myFile.png
                                       description: Path to file on the device file system
                                    size:
                                       type: number
                                       example: 1024
                                       description: Size of the file in bytes
                           wifiNetworks:
                              type: array
                              description: (Optional) List of wifi networks deployed on the configuration
                              required: false
                              items:
                                 type: object
                                 properties:
                                    id:
                                       type: string
                                       example: 1tZw3kuoOfcZMgbIs8
                                       description: Unique identifier of the wifi network
                                    ssid:
                                       type: string
                                       example: SF_Office_123
                                       description: SSID of the wifi network
                                    nickname:
                                       type: string
                                       example: SF Office wifi main
                                       description: Nickname of the wifi network
                                    type:
                                       type: string
                                       enum:
                                          - OPEN
                                          - WPA
                                          - WPA_ENTERPRISE
                                          - WPA3
                                          - WPA3_ENTERPRISE
                                          - UNKNOWN
                                       example: WPA_ENTERPRISE
                                       description: Type of wifi network
                           kioskAppId:
                              type: string
                              example:
                                 available: 10707AB329856
                              description: (Optional) The unique identifier of the Kiosk App, if one is present and the configuration uses `deviceExperience` =  `KIOSK`.
   /organizations/{orgId}/configurations:
      get:
         description: Retrieve a list of all configurations.
         parameters:
            - name: orgId
              in: path
              required: true
              schema:
                 type: string
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
         responses:
            "200":
               description: A list of configuration summary objects.
               content:
                  application/json:
                     schema:
                        type: array
                        items:
                           properties:
                              id:
                                 type: string
                                 description: Unique identifier of the configuration
                              name:
                                 type: string
                                 description: Name of the configuration
                              registrationCode:
                                 type: string
                                 description: Configuration code (formerly known as Registration Code) for the configuration. [Learn More](https://help.managexr.com/en/articles/5345978-register-a-device-using-a-registration-code)
                              deviceCount:
                                 type: number
                                 description: Number of devices using the configuration
                        example:
                           - id: 6qwM6FzJE4o708iqTpWc
                             name: Education
                             registrationCode: f7GbHvH
                             deviceCount: 15
                           - id: 7xzA3LrJS5b903jrTpYd
                             name: Employee Training
                             registrationCode: a8YhTzK
                             deviceCount: 30
   /organizations/{orgId}/configurations/duplicate:
      post:
         summary: Duplicate configuration
         description: Create a new configuration by duplicating an existing one.
         parameters:
            - name: orgId
              in: path
              required: true
              description: The ID of the organization. Locate the orgId under Organization Settings > API Keys.
              schema:
                 type: string
         requestBody:
            required: true
            content:
               application/json:
                  schema:
                     type: object
                     required:
                        - name
                        - configurationId
                     properties:
                        name:
                           type: string
                           description: New configuration name
                        configurationId:
                           type: string
                           description: Unique identifier of the configuration to duplicate
                  examples:
                     example-request:
                        summary: Duplicate a configuration
                        value:
                           name: Config v2
                           configurationId: TY8ZiuJoxuy51fsSxXp0
         responses:
            "201":
               description: A configuration summary object
               content:
                  application/json:
                     schema:
                        type: object
                        properties:
                           id:
                              type: string
                              description: Unique identifier of the configuration
                           name:
                              type: string
                              description: Name of the configuration
                           registrationCode:
                              type: string
                              description: Configuration code (formerly known as Registration Code) for the configuration. [Learn More](https://help.managexr.com/en/articles/5345978-register-a-device-using-a-registration-code)
                           deviceCount:
                              type: number
                              description: Number of devices using the configuration
                     example:
                        id: 6qwM6FzJE4o708iqTpWc
                        name: Config v2
                        registrationCode: f7GbHvH
                        deviceCount: 0
   ##################################################
   # Organization
   ##################################################
   /organizations:
      get:
         description: |
            Retrieve a list of all organizations that can be controlled with a given API Key

            <small><b>Need a multi-org API key?</b> Email support@managexr.com for early access to a single API key that allows you to control multiple organizations</small>
         responses:
            "200":
               description: A list of organization summary objects.
               content:
                  application/json:
                     schema:
                        type: array
                        items:
                           properties:
                              id:
                                 type: string
                                 description: Unique identifier of the organization
                              name:
                                 type: string
                                 description: Name of the organization
                              activeDevices:
                                 type: string
                                 description: Number of devices currently registered on the organization
                              deviceLicenses:
                                 type: number
                                 description: Number of device licenses
                        example:
                           - id: A1ZICsr6XwX5fv4E16QM
                             name: High school Musical
                             activeDevices: 30
                             deviceLicenses: 50
                           - id: EwmhggZ9zYIqMVVMz2s7
                             name: Sky High
                             activeDevices: 50
                             deviceLicenses: 100

components:
   schemas:
      V1ContentAppManaged:
         type: object
         title: App
         description: __App (managed)__. Managed apps deployed on the configuration will include the attributes listed below
         properties:
            contentType:
               type: string
               enum: [app]
            title:
               type: string
               description: Title of the app
               example: "My Custom VR App"
            packageName:
               type: string
               description: Package name of the app
               example: "com.picovr.launcher"
            iconUrl:
               type: string
               format: uri
               example: "https://firebasestorage.googleapis.com/v0/b/example.jpg"
            id:
               type: string
               description: Unique identifier of the app version
               example: "av_123"
            type:
               type: string
               enum: [managed, shared, external, instant]
               description: Type of the app version
               example: "managed"
            configurationDeployments:
               type: object
               description: Map of configuration ids to device count using application
               example: { "config_123": 1, "config_456": 0 }
            createdAt:
               type: number
               description: Creation timestamp
               example: 1645615777448
            updatedAt:
               type: number
               description: Last update timestamp
               example: 1687352117203
            versionCode:
               type: number
               description: Version code of the app
               example: 83894522
            versionName:
               type: string
               description: Version name of the app
               example: "8.7.8.1206"
            versionLabel:
               type: string
               description: Label for uniqueness among app versions
               example: "Quest"
            apkSize:
               type: number
               description: Size of the APK file in bytes
               example: 72633861
            obbSize:
               type: number
               description: Size of the OBB file in bytes
               example: 1024
            selfHosted:
               type: boolean
               description: Whether the app is self-hosted
               example: true
            apkUrl:
               type: string
               description: URL of the APK file (self-hosted apps only)
               example: "https://storage.example.com/apps/com.example.app.apk"
            obbUrl:
               type: string
               description: URL of the OBB file (self-hosted apps only)
               example: "https://storage.example.com/apps/com.example.app.obb"
            sharingOrganizationName:
               type: string
               description: Name of the organization sharing the app (shared apps only)
               example: "XR Developer"
            releaseChannelName:
               type: string
               description: Name of the release channel (shared apps only)
               example: "Production"
            supportedDeviceModels:
               type: array
               items:
                  type: string
                  example: "Quest 3"
               description: List of supported device models for Instant App (instant apps only)
               example: ["Quest 3", "Quest 3S", "Pico 4 Ultra Enterprise"]
         example:
            contentType: app
            id: "kaldh3907hjxmi219"
            title: "My Custom VR App"
            packageName: "com.picovr.vrlauncher"
            iconUrl: "https://storage.example.com/apps/com.example.app/icon.png"
            createdAt: 1645615777448
            updatedAt: 1687352117203
            configurationDeployments: { "config_123": 1 }
            type: managed
            versionCode: 10203
            versionName: "1.2.3"
            versionLabel: "quest"
            apkSize: 1204975930
            obbSize: 19097894
            selfHosted: false
      V1ContentVideo:
         type: object
         title: Video
         description: Videos deployed on the configuration will include the attributes listed below
         required:
            [
               contentType,
               id,
               title,
               size,
               type,
               display,
               mapping,
               packing,
               iconUrl,
               createdAt,
               updatedAt,
            ]
         properties:
            contentType:
               type: string
               enum: [video]
            id:
               type: string
               description: Unique identifier of the video
            title:
               type: string
               description: Title of the video
            size:
               type: number
               description: Size of the video in bytes
            type:
               type: string
               enum:
                  - _360
                  - _180
                  - _2D
               example: "_360"
               description: Type of video
            display:
               type: string
               enum:
                  - "MONO"
                  - "STEREO"
               example: "MONO"
               description: Video display type
            mapping:
               type: string
               enum:
                  - "NONE"
                  - "EQUIRECTANGULAR"
                  - "CUBEMAP"
               example: "EQUIRECTANGULAR"
               description: Video mapping
            packing:
               type: string
               enum:
                  - "NONE"
                  - "TOP_BOTTOM"
                  - "LEFT_RIGHT"
               example: "TOP_BOTTOM"
               description: Video packing (stereoscopic videos only)
            md5:
               type: string
               description: MD5 hash of the video file
            iconUrl:
               type: string
               format: uri
               description: URL of the video's icon
            createdAt:
               type: number
               description: Creation timestamp
               example: 1645615777448
            updatedAt:
               type: number
               description: Last update timestamp
               example: 1687352117203
            description:
               type: string
               description: Optional description of the video
         example:
            contentType: video
            id: "gF0ODIEvXSwsjqtP0CgVo"
            title: "Discover San Francsico"
            description: "[360 Mono Cubemap] 1 MB"
            size: 553657
            type: "_360"
            display: "MONO"
            mapping: "CUBEMAP"
            packing: "NONE"
            md5: "7ah69cMtXyaz5OfsCRtOjQ=="
            iconUrl: "https://firebasestorage.googleapis.com/v0/b/example.jpg"
            createdAt: 1696978504660
            updatedAt: 1715651553616
      V1ContentLink:
         type: object
         title: WebXR Link
         description: WebXR links deployed on the configuration will include the attributes listed below
         required: [contentType, id, title, url, iconUrl, createdAt, updatedAt]
         properties:
            contentType:
               type: string
               enum: [link]
               description: Type of content
            id:
               type: string
               description: Unique identifier of the webxr link
            title:
               type: string
               description: Title of the webxr link
            url:
               type: string
               format: uri
               description: WebXR link url to open in-headset
            iconUrl:
               type: string
               format: uri
               description: URL of the webxr link's icon
            createdAt:
               type: number
               description: Creation timestamp
               example: 1645615777448
            updatedAt:
               type: number
               description: Last update timestamp
               example: 1687352117203
         example:
            contentType: link
            id: "A3t67LlxH99cKeprazuc"
            title: "Virtual College Tour"
            url: "https://www.youtube.com/watch?v=AyWLvrWBKHA"
            iconUrl: "https://firebasestorage.googleapis.com/v0/b/icon.png"
            createdAt: 1706719137865
            updatedAt: 1706719137865
      V1ManagedFile:
         type: object
         properties:
            id:
               type: string
               description: Unique identifier of the file
               example: "DLO133U5NFLMAL1"
            url:
               type: string
               format: uri
               description: Direct URL to download the file. If hosted on ManageXR, the link will begin with `gs://`. If self-hosted, it will be the url you supplied when creating the file.
               example: "gs://mighty-platform-prod/organizations/GMrDmBCRcUm4bf61nqH2/files/e75058f2-ee65-4a79-802e-b97af54b6b26"
            name:
               type: string
               description: Name of the file, including extension
               example: "main_assets_all.bundle"
            size:
               type: number
               description: Size of the file in bytes
               example: 1204975930
            md5:
               type: string
               description: MD5 hash of the file for integrity verification
               example: "7ah69cMtXyaz5OfsCRtOjQ=="
            description:
               type: string
               description: Optional description of the file's contents or purpose
               example: "Content bundle for training app"
            libraryDirectoryPath:
               type: string
               description: Path to the file in the Library > Files section of ManageXR. A libraryDirectoryPath of "/" indicates that it is at the root of the Files library.
               example: "/"
         example:
            id: "DLO133U5NFLMAL1"
            url: "https://storage.googleapis.com/managexr-files/org_456/files/file_123abc.mp4"
            name: "main_assets_all.bundle"
            size: 1204975930
            md5: "7ah69cMtXyaz5OfsCRtOjQ=="
            description: "Content bundle for training app"
            libraryDirectoryPath: "/"
      V1ManagedFileDeployed:
         type: object
         properties:
            id:
               type: string
               description: Unique identifier of the file
               example: "DLO133U5NFLMAL1"
            url:
               type: string
               format: uri
               description: Direct URL to download the file. If hosted on ManageXR, the link will begin with `gs://`. If self-hosted, it will be the url you supplied when creating the file.
               example: "gs://mighty-platform-prod/organizations/GMrDmBCRcUm4bf61nqH2/files/e75058f2-ee65-4a79-802e-b97af54b6b26"
            name:
               type: string
               description: Name of the file, including extension
               example: "main_assets_all.bundle"
            size:
               type: number
               description: Size of the file in bytes
               example: 1204975930
            md5:
               type: string
               description: MD5 hash of the file for integrity verification
               example: "7ah69cMtXyaz5OfsCRtOjQ=="
            description:
               type: string
               description: Optional description of the file's contents or purpose
               example: "Content bundle for training app"
            libraryDirectoryPath:
               type: string
               description: Path to the file in the Library > Files section of ManageXR. A libraryDirectoryPath of "/" indicates that it is at the root of the Files library.
               example: "/"
            deviceDirectoryPaths:
               type: array
               description: Directory paths where the file is placed on the device. This is an array because, although uncommon, you can deploy a file to more than one location on a device.
               items:
                  type: string
               example: ["/Android/obb/com.managexr.exampleApp/files"]
         example:
            id: "DLO133U5NFLMAL1"
            url: "https://storage.googleapis.com/managexr-files/org_456/files/file_123abc.mp4"
            name: "main_assets_all.bundle"
            size: 1204975930
            md5: "7ah69cMtXyaz5OfsCRtOjQ=="
            description: "Content bundle for training app"
            libraryDirectoryPath: "/"
            deviceDirectoryPaths: ["/Android/obb/com.managexr.exampleApp/files"]
      V1ManagedFileDto:
         type: object
         properties:
            url:
               type: string
               format: uri
               description: Publicly accessible direct URL to download the file. ManageXR will use this url to download the file to devices.
               example: "https://my-bucket-name.s3.amazonaws.com/main_assets_all.bundle"
            name:
               type: string
               description: Name of the file, including extension
               example: "main_assets_all.bundle"
            size:
               type: number
               description: Size of the file in bytes
               example: 1204975930
            md5:
               type: string
               description: MD5 hash of the file for integrity verification
               example: "7ah69cMtXyaz5OfsCRtOjQ=="
            description:
               type: string
               description: Optional description of the file's contents or purpose
               example: "Content bundle for training app"
            libraryDirectoryPath:
               type: string
               description: Path to the file in the Library > Files section of ManageXR. A libraryDirectoryPath of "/" indicates that it is at the root of the Files library.
               example: "/"
         example:
            url: "https://my-bucket-name.s3.amazonaws.com/main_assets_all.bundle"
            name: "main_assets_all.bundle"
            size: 1204975930
            md5: "7ah69cMtXyaz5OfsCRtOjQ=="
            description: "Content bundle for training app"
            libraryDirectoryPath: "/"
      V1BundledFileEditDto:
         type: object
         properties:
            id:
               type: string
               description: Unique identifier of the file
               example: "DLO133U5NFLMAL1"
            deviceDirectoryPaths:
               type: array
               description: Array of directory paths to deploy the file on the device. Each entry in the array should include the full path as a string. This field is an array because, although uncommon, you can deploy the same file to multiple different locations on a device.
               items:
                  type: string
                  desciption: "Full directory path to location for file on device."
                  example: "/Android/obb/com.managexr.exampleApp/files"
         example:
            id: "DLO133U5NFLMAL1"
            deviceDirectoryPaths:
               - "/Android/obb/com.managexr.exampleApp/files"
      V1WifiNetwork:
         type: object
         description: A Wi-Fi network profile summary
         properties:
            id:
               type: string
               description: Unique identifier of the Wi-Fi network
               example: "wifi_abc123"
            ssid:
               type: string
               description: The SSID (name) of the Wi-Fi network
               example: "MyNetwork"
            nickname:
               type: string
               description: A user-defined label for the network
               example: "Office Wi-Fi"
            type:
               type: string
               description: The security type of the network
               enum:
                  - OPEN
                  - WPA
                  - WPA_ENTERPRISE
                  - WPA3
                  - WPA3_ENTERPRISE
                  - UNKNOWN
               example: WPA_ENTERPRISE
            priorityWifiNetwork:
               type: boolean
               description: Priority network. The device will always connect to this network over other networks when it is in range and available.
               example: false
         example:
            id: "wifi_abc123"
            ssid: "MyNetwork"
            nickname: "Office Wi-Fi"
            type: WPA_ENTERPRISE
            priorityWifiNetwork: false
      V1AppIdentifier:
         type: object
         properties:
            packageName:
               type: string
               description: Package name of the app
               example: "com.myapp.quest"
            version:
               oneOf:
                  - $ref: "#/components/schemas/V1AppVersionIdentifier"
      V1AppVersionShortcutIdentifier:
         type: string
         enum:
            - latest
            - last-created
      V1AppVersionIdentifierRetired:
         type: object
         properties:
            versionCode:
               type: number
               description: App version code
               example: 42
            versionName:
               type: string
               description: App version name
               example: "4.2.0"
            versionLabel:
               type: string
               description: Optional version label (e.g. 'Stable', 'Beta', 'Quest'). Used to differentiate app versions with the same name and code.
               example: "Stable"
         required:
            - versionCode
            - versionName
         example:
            versionCode: 42
            versionName: "4.2.0"
            versionLabel: "Stable"
      V1AppVersionIdOnly:
         type: string
         description: Unique identifier of app version, video, or link on ManageXR
         example: "LAKDJFLAKJ21JK34"
      V1VrContentProperties:
         type: object
         description: Optional per item properties.
         properties:
            hidden:
               type: boolean
               description: |
                  When **true**, the content item is hidden on the Home Screen.
                  Omit this field (or set to false) to show the item.
            forceInstall:
               type: boolean
               description: |
                  When **true** uninstalls previous version of app before re-installing new version. Turn on Force Install if you need to downgrade or rollback an app version. [Learn More](https://help.managexr.com/en/articles/5274045-deploying-applications#h_ddb1b059c3)
      V1VideoIdentifier:
         type: object
         title: Video
         properties:
            id:
               type: string
               description: Unique identifier of the video
               example: "KD32I5NGL1345"
            type:
               type: string
               enum:
                  - video
               example: video
            properties:
               $ref: "#/components/schemas/V1VrContentProperties"
      V1WebXRIdentifier:
         type: object
         title: WebXR Link
         properties:
            id:
               type: string
               description: Unique identifier of the webxr link
               example: "KD32I5NGL133k8"
            type:
               type: string
               enum:
                  - link
               example: link
            properties:
               $ref: "#/components/schemas/V1VrContentProperties"
      V1AppVersionIdentifier:
         type: object
         title: App (Specific Version)
         properties:
            id:
               description: Unique identifier of the app
               type: object
               properties:
                  packageName:
                     type: string
                     description: Package Name of the application
                  version:
                     oneOf:
                        - type: string
                          description: |
                             Use a shortcut to identify a recent version. "latest" = latest semver version. "last-created" = most recently created on ManageXR. 

                             _Select from the dropdown above for other version identification options_
                          enum: ["latest", "last-created"]
                        - type: object
                          description: Identify a specific version using the standard version information.
                          properties:
                             versionCode:
                                type: number
                                description: App version code
                                example: 42
                             versionName:
                                type: string
                                description: App version name
                                example: "4.2.0"
                             versionLabel:
                                type: string
                                description: Optional version label (e.g. 'Stable', 'Beta', 'Quest'). Used to differentiate app versions with the same name and code.
                                example: "Stable"
                          required: [versionCode, versionName]
                        - type: string
                          description: Unique identifier of app version on ManageXR. You can retrieve this using the List App Versions endpoint.
            properties:
               $ref: "#/components/schemas/V1VrContentProperties"
            type:
               type: string
               enum: [app]
               example: app

      V1AppReleaseIdentifier:
         type: object
         title: App (Release Channel)
         description: We recommend using release channels to deploy apps to configurations to simplify app version management. Instead of updating the app version on every configuration whenever you have an update, simply update the release channel. [Learn More](https://help.managexr.com/en/articles/5518816-release-channels)
         properties:
            id:
               description: Unique identifier of the app
               type: object
               properties:
                  packageName:
                     type: string
                     description: Package Name of the application
                  releaseChannel:
                     type: string
                     description: Name of the release channel
                  type:
                     enum:
                        - shared
                        - managed
               required: [packageName, releaseChannel]
            type:
               type: string
               enum:
                  - app
               example: app
            properties:
               $ref: "#/components/schemas/V1VrContentProperties"
      V1AppReleaseIdentifierKiosk:
         type: object
         title: App (Release Channel)
         properties:
            type:
               type: string
               enum:
                  - app
               example: app
            id:
               description: Unique identifier of the app
               type: object
               properties:
                  packageName:
                     type: string
                     description: Package Name of the application
                  releaseChannel:
                     type: string
                     description: Name of the release channel
                  type:
                     enum:
                        - shared
                        - managed
               required: [packageName, releaseChannel]
      V1AppVersionIdentifierKiosk:
         type: object
         title: App (Specific Version)
         properties:
            type:
               type: string
               enum:
                  - app
               example: app
            id:
               description: Unique identifier of the app
               type: object
               properties:
                  packageName:
                     type: string
                     description: Package Name of the application
                  version:
                     oneOf:
                        - type: object
                          description: Identify a specific version using the standard version information.
                          properties:
                             versionCode:
                                type: number
                                description: App version code
                                example: 42
                             versionName:
                                type: string
                                description: App version name
                                example: "4.2.0"
                             versionLabel:
                                type: string
                                description: Optional version label (e.g. 'Stable', 'Beta', 'Quest'). Used to differentiate app versions with the same name and code.
                                example: "Stable"
                          required: [versionCode, versionName]
                        - type: string
                          description: |
                             Use a shortcut to identify a recent version. "latest" = latest semver version. "last-created" = most recently created on ManageXR. 

                             _Select from the dropdown above for other version identification options_
                          enum: ["latest", "last-created"]
                        - type: string
                          description: Unique identifier of app version on ManageXR. You can retrieve this using the List App Versions endpoint.
      V1VideoIdentifierKiosk:
         type: object
         title: Video
         properties:
            type:
               type: string
               enum:
                  - video
               example: video
            id:
               type: string
               description: Unique identifier of the video
               example: "KD32I5NGL1345"
            properties:
               type: object
               properties:
                  kioskVideoSettings:
                     type: object
                     properties:
                        loopVideo:
                           type: boolean
                           description: Whether to play the video on loop
                           example: true
                        loopVideoAfterNSecondsHeadsetOff:
                           type: number
                           enum: [0, 3, 10, 20, 30, 60, 300, 600]
                           description: Reset video play position to the beginning after headset has been taken off for N seconds
                           example: 30
      V1ConfigurationVrContentPatch:
         type: array
         description: An array of VR content deployed on the configuration. Fields vary by content type. Objects are ordered in the manner they appear on the Home Screen.
         items:
            oneOf:
               - $ref: "#/components/schemas/V1AppReleaseIdentifier"
               - $ref: "#/components/schemas/V1AppVersionIdentifier"
               - $ref: "#/components/schemas/V1VideoIdentifier"
               - $ref: "#/components/schemas/V1WebXRIdentifier"
      V1ConfigurationKioskContentPatch:
         oneOf:
            - $ref: "#/components/schemas/V1AppReleaseIdentifierKiosk"
            - $ref: "#/components/schemas/V1AppVersionIdentifierKiosk"
            - $ref: "#/components/schemas/V1VideoIdentifierKiosk"
         discriminator:
         propertyName: type
         mapping:
            appRelease: "#/components/schemas/V1AppReleaseIdentifier"
            appVersion: "#/components/schemas/V1AppVersionIdentifier"
            video: "#/components/schemas/V1VideoIdentifier"

      V1ConfigurationVrContentResponse:
         type: array
         description: An array of VR content deployed on the configuration. Fields vary by content type. Objects are ordered in the manner they appear on the Home Screen.
         items:
            oneOf:
               - $ref: "#/components/schemas/V1AppVersionResponse"
               - $ref: "#/components/schemas/V1ContentVideo"
               - $ref: "#/components/schemas/V1ContentLink"
      V1AppVersionResponse:
         title: Apps
         description: Apps deployed on the configuration will include the attributes listed below
         type: object
         properties:
            id:
               type: string
               description: Unique identifier of the app version
               example: "av_123"
            type:
               type: string
               enum: [managed, shared, external, instant]
               description: Type of the app version
               example: "managed"
            configurationDeployments:
               type: object
               additionalProperties:
                  type: number
               description: Map of configuration ids to device count using application
               example: { "config_123": 1, "config_456": 0 }
            createdAt:
               type: number
               description: Creation timestamp
               example: 1645615777448
            updatedAt:
               type: number
               description: Last update timestamp
               example: 1687352117203
            versionCode:
               type: number
               description: Version code of the app
               example: 83894522
            versionName:
               type: string
               description: Version name of the app
               example: "8.7.8.1206"
            versionLabel:
               type: string
               description: Label for uniqueness among app versions
               example: "Quest"
            hidden:
               type: boolean
               description: Whether the app is hidden from the VR home screen
               example: false
            forceInstall:
               type: boolean
               description: When **true** uninstalls previous version of app before re-installing new version. Turn on Force Install if you need to downgrade or rollback an app version. [Learn More](https://help.managexr.com/en/articles/5274045-deploying-applications#h_ddb1b059c3)
               example: false
            apkSize:
               type: number
               description: Size of the APK file in bytes
               example: 72633861
            obbSize:
               type: number
               description: Size of the OBB file in bytes
               example: 1024
            selfHosted:
               type: boolean
               description: Whether the app is self-hosted
               example: true
            apkUrl:
               type: string
               description: URL of the APK file (self-hosted apps only)
               example: "https://storage.example.com/apps/com.example.app.apk"
            obbUrl:
               type: string
               description: URL of the OBB file (self-hosted apps only)
               example: "https://storage.example.com/apps/com.example.app.obb"
            sharingOrganizationName:
               type: string
               description: Name of the organization sharing the app (shared apps only)
               example: "XR Developer"
            releaseChannelName:
               type: string
               description: Name of the release channel (shared apps only)
               example: "Production"
            supportedDeviceModels:
               type: array
               items:
                  type: string
                  example: "Quest 3"
               description: List of supported device models for Instant App (instant apps only)
               example:
                  - "Quest 3"
                  - "Quest 3S"
                  - "Pico 4 Ultra Enterprise"
      V1ConfigurationPatchDto:
         type: object
         description: Configuration object
         properties:
            id:
               type: string
               description: Unique identifier of the configuration.
               example: "sFidGmedeQofSBcvRcyn"

            name:
               type: string
               description: Name of the configuration.
               example: "Education"

            registrationCode:
               type: string
               description: Configuration code (formerly known as registration code) used for enrollment.
               example: "f7GbHvH"

            deviceCount:
               type: number
               description: Number of devices using the configuration.
               example: 15

            deviceExperienceMode:
               type: string
               description: Device experience set on the configuration. Default is Home Screen.
               enum: [HOME_SCREEN, KIOSK, KIOSK_VIDEO, DEFAULT]
               example: HOME_SCREEN

            vrContent:
               $ref: "#/components/schemas/V1ConfigurationVrContentPatch"

            files:
               type: array
               description: Files deployed on the configuration.
               items:
                  oneOf:
                     - $ref: "#/components/schemas/V1ManagedFile"

            wifiNetworks:
               type: array
               description: Wi‑Fi network profiles deployed on the configuration.
               items:
                  oneOf:
                     - $ref: "#/components/schemas/V1WifiNetwork"

      V1ConfigurationResponse:
         type: object
         description: Full representation of a configuration.
         properties:
            id:
               type: string
               description: Unique identifier of the configuration.
               example: "sFidGmedeQofSBcvRcyn"

            name:
               type: string
               description: Name of the configuration.
               example: "Education"

            registrationCode:
               type: string
               description: Configuration code (formerly known as registration code) used for enrollment.
               example: "f7GbHvH"

            deviceCount:
               type: number
               description: Number of devices using the configuration.
               example: 15

            deviceExperienceMode:
               type: string
               description: Device experience set on the configuration. Default is Home Screen.
               enum: [HOME_SCREEN, KIOSK, KIOSK_VIDEO, DEFAULT]
               example: HOME_SCREEN
            vrContent:
               $ref: "#/components/schemas/V1ConfigurationVrContentResponse"
            kioskVrContent:
               $ref: "#/components/schemas/V1ConfigurationKioskContentPatch"
            kioskVideoSettings:
               type: object
               description: Only relevant if configuration `deviceExperienceMode` is `KIOSK_VIDEO`
               properties:
                  loopVideo:
                     type: boolean
                     description: Whether to play the video on loop
                     example: true
                  loopVideoAfterNSecondsHeadsetOff:
                     type: number
                     enum: [0, 3, 10, 20, 30, 60, 300, 600]
                     description: Reset video play position to the beginning after headset has been taken off for N seconds
                     example: 30
            files:
               type: array
               description: Files deployed on the configuration.
               items:
                  oneOf:
                     - $ref: "#/components/schemas/V1ManagedFileDeployed"
            wifiNetworks:
               type: array
               description: Wi‑Fi network profiles deployed on the configuration.
               items:
                  oneOf:
                     - $ref: "#/components/schemas/V1WifiNetwork"

      V1Device:
         type: object
         description: Full representation of a device managed in ManageXR
         properties:
            id:
               type: string
               description: The device ID (serial number)
               example: "12345678901234"
            serial:
               type: string
               description: Device serial number
               example: "12345678901234"
            name:
               type: string
               description: The device name
               example: "Training Room 1"
            mac:
               type: string
               description: MAC address of the device
               example: "CE:AF:07:47:E0:AE"
            model:
               type: string
               description: The device model
               example: "Quest 2"
            manufacturer:
               type: string
               description: The device manufacturer
               example: "Meta"
            notes:
               type: string
               description: Optional user-provided notes about the device
               example: "Mounted in Room 5"
            batteryLevel:
               type: number
               description: Battery level percentage
               example: 87
            batteryIsCharging:
               type: boolean
               description: Whether the device is currently charging
               example: true
            pauseUpdates:
               type: boolean
               description: Whether updates are paused for this device
               example: false
            online:
               type: boolean
               description: Whether the device is currently online
               example: true
            osVersion:
               type: string
               description: The OS version running on the device
               example: "Android 12"
            outOfDate:
               type: boolean
               description: Whether the device is running outdated software
               example: true
            registerDate:
               type: string
               format: date-time
               description: The date this device was registered with ManageXR
               example: "2023-11-12T10:30:00Z"
            updating:
               type: boolean
               description: Whether the device is currently performing an update
               example: false
            factoryResetStatus:
               type: string
               description: Status of any pending or active factory reset
               example: "NONE"
            firmwareVersion:
               type: string
               description: Firmware version reported by the device
               example: "Oculus OS 46.0.0.230"
            configuration:
               type: object
               description: The configuration assigned to this device
               properties:
                  id:
                     type: string
                     example: "sFidGmedeQofSBcvRcyn"
                  name:
                     type: string
                     example: "Training Configuration"
            tags:
               type: array
               description: Tags assigned to this device
               items:
                  type: object
                  properties:
                     id:
                        type: string
                        example: "tag_abc123"
                     name:
                        type: string
                        example: "Lab Devices"
            tutorialModeEnabled:
               type: boolean
               description: Whether tutorial mode is enabled
               example: false
            kioskModeOverride:
               type: boolean
               description: True if device has Kiosk Mode/ManageXR Home Screen disabled. When true, the device is not locked into the ManageXR Home Screen or Kiosk App and users have full access to the native system menus. [Learn more](https://help.managexr.com/en/articles/5416931-temporarily-disable-kiosk-mode-home-screen)
               example: true
            lastSync:
               type: string
               format: date-time
               description: The last time the device checked in with ManageXR. Online devices check in every 15 minutes.
               example: "2024-04-20T17:23:12Z"
            ram:
               type: object
               description: RAM usage info
               properties:
                  available:
                     type: number
                     description: Available RAM in bytes
                     example: 2147483648
                  total:
                     type: number
                     description: Total RAM in bytes
                     example: 4294967296
            storage:
               type: object
               description: Internal storage usage info
               properties:
                  available:
                     type: number
                     description: Available storage in bytes
                     example: 15728640000
            location:
               type: object
               description: Approximate location of the device
               properties:
                  city:
                     type: string
                     example: "San Francisco"
                  region:
                     type: string
                     example: "California"
                  country:
                     type: string
                     example: "US"
                  continent:
                     type: string
                     example: "North America"
                  timeZone:
                     type: string
                     example: "America/Los_Angeles"
                  longitude:
                     type: number
                     example: -122.4194
                  latitude:
                     type: number
                     example: 37.7749
            connectedWifiNetwork:
               type: object
               description: Current connected Wi-Fi network
               properties:
                  ssid:
                     type: string
                     example: "ManageXR-Office"
            currentForegroundApp:
               type: object
               description: Currently running app in the foreground
               properties:
                  packageName:
                     type: string
                     example: "com.my.app"
                  title:
                     type: string
                     example: "My Training App"
            controllerData:
               type: object
               description: Data about connected controllers
               properties:
                  controller0:
                     type: object
                     properties:
                        batteryLevel:
                           type: number
                           example: 85
                        version:
                           type: string
                           example: "v14"
                  controller1:
                     type: object
                     properties:
                        batteryLevel:
                           type: number
                           example: 82
                        version:
                           type: string
                           example: "v14"
      V1DeviceSyncStatusAppVersion:
         type: object
         description: Version identifier for an installed or target app. All fields are optional because not every app category reports version metadata (e.g. some external/store apps).
         properties:
            versionCode:
               type: number
               description: Numeric version code.
               example: 700402468
            versionName:
               type: string
               description: Human-readable version name.
               example: "76.0.0.0.410"
            versionLabel:
               type: string
               description: Optional release-channel label associated with the version.
               example: "stable"
      V1DeviceSyncStatusAppEntry:
         type: object
         description: Sync status for a single app on a device.
         required:
            - packageName
            - installed
            - outOfDate
            - hasError
         properties:
            packageName:
               type: string
               description: Android package name of the app.
               example: "com.oculus.panelapp.kiosk"
            installed:
               type: boolean
               description: Whether the app is currently installed on the device. Reflects managed apps only — sideloaded apps are not represented.
               example: true
            outOfDate:
               type: boolean
               description: Whether the installed version differs from the configuration's target version.
               example: false
            hasError:
               type: boolean
               description: Whether the device reported an error for this app on its last sync.
               example: false
            currentVersion:
               $ref: "#/components/schemas/V1DeviceSyncStatusAppVersion"
            targetVersion:
               $ref: "#/components/schemas/V1DeviceSyncStatusAppVersion"
      V1DeviceSyncStatus:
         type: object
         description: |
            Per-content-category sync status for a single device. Optional content fields (e.g. `appSyncStatuses`) are populated based on the `include` query parameter — fields for unrequested categories are omitted.

            For a device's overall up-to-date status, use the top-level `outOfDate` boolean on `V1Device` (returned by `GET /v1/devices` and `GET /v1/devices/{id}`).
         required:
            - deviceId
            - serial
         properties:
            deviceId:
               type: string
               description: The device ID (serial number).
               example: "340YC10G8D14ML"
            serial:
               type: string
               description: Device serial number.
               example: "340YC10G8D14ML"
            appSyncStatuses:
               type: array
               description: Per-app sync entries. Present when `include=apps` was passed; absent otherwise.
               items:
                  $ref: "#/components/schemas/V1DeviceSyncStatusAppEntry"
      WifiNetworkType:
         type: string
         enum: [OPEN, WPA, WPA_ENTERPRISE, WPA3, WPA3_ENTERPRISE, UNKNOWN]
      EapMethod:
         type: string
         enum: [PEAP, TLS, TTLS, PWD, NONE]
      Phase2Method:
         type: string
         enum: [PAP, MSCHAP, MSCHAPV2, GTC, NONE]
      ProxySettingType:
         type: string
         enum: [PAC, MANUAL, NONE]
      KeySize:
         type: string
         enum: [NONE, "1024", "2048"]
      KeyUsage:
         type: string
         enum: [NONE, DIGITAL_SIGNATURE, KEY_ENCIPHERMENT]
      ExtendedKeyUsage:
         type: string
         enum: [NONE, CLIENT_AUTHENTICATION, SERVER_AUTHENTICATION, ANY_PURPOSE]
      SubjectAlternativeNameIdType:
         type: string
         enum: [EMAIL_ADDRESS, USER_PRINCIPAL_NAME, DNS, URI]
      DynamicFieldValue:
         type: string
         enum: ["%device_name%", "%device_serial%", "%device_mac%"]
      CreateWifiNetworkDto:
         type: object
         properties:
            ssid:
               type: string
               minLength: 2
               maxLength: 32
               description: Name of the Wi-Fi network to connect to.
            password:
               type: string
               description: Password. Optional if the Wi-Fi type is OPEN.
            nickname:
               type: string
               description: Optional user-friendly label for the network.
            type:
               $ref: "#/components/schemas/WifiNetworkType"
               description: Type of the network. Note, WPA is WPA2. WPA_ENTERPRISE is WPA2 Enterprise.
            hidden:
               type: boolean
               description: Whether the network is hidden (SSID not broadcast).
            disableMacRandomization:
               type: boolean
               description: Whether to disable mac address randomization when this network is deployed on a device
            eapMethod:
               $ref: "#/components/schemas/EapMethod"
               description: Enterprise EAP method (PEAP, TLS, TTLS, etc).
            phase2Method:
               $ref: "#/components/schemas/Phase2Method"
               description: Inner authentication method used with the EAP method. Required for EAP methods PEAP and TTLS.
            identity:
               type: string
               description: Identity used for enterprise network authentication. Required for WPA2-Enterprise network types.
            anonymousIdentity:
               type: string
               description: Anonymous identity used in outer identity requests. Required for EAP-PEAP and EAP-TTLS networks.
            domain:
               type: string
               description: Radius Server Domain. Required for EAP-PEAP, EAP-TLS, and EAP-TTLS WPA2-Enterprise networks on devices running Android 14 and above. This includes many of the latest Meta Quest and Pico devices. This field validates the certificate the server presents to the device, and prevents security vulnerabilities.
            userCertificatePem:
               type: string
               description: PEM-encoded user certificate, required for EAP-TLS networks.
            caCertificatePem:
               type: string
               description: PEM-encoded certificate authority certificate for server validation. Required for EAP-PEAP, EAP-TLS, and EAP-TTLS WPA2-Enterprise networks on devices running Android 14 and above. This includes many of the latest Meta Quest and Pico devices. Learn about [certificate formatting](https://help.managexr.com/en/articles/7131251-deploying-enterprise-wi-fi-certificates-on-managexr)
            proxySettingType:
               $ref: "#/components/schemas/ProxySettingType"
               description: "Defines how proxy is configured: PAC, MANUAL, or NONE."
            proxyHost:
               type: string
               description: Hostname or IP of the manual proxy server.
            proxyPort:
               type: number
               minimum: 0
               maximum: 65535
               description: Port number of the manual proxy server.
            proxyHostExclusionList:
               type: array
               items:
                  type: string
               description: List of hostnames that bypass the proxy.
            proxyPacUrl:
               type: string
               description: URL to a PAC (proxy auto-config) file.
         required:
            - ssid
            - type
         example:
            ssid: "AcmeCorpSecure"
            nickname: "Office WiFi"
            type: WPA
            password: password
            hidden: false
            disableMacRandomization: true

   securitySchemes:
      basicAuth:
         type: http
         scheme: basic
         description: |
            API key based authentication where <encoded-value> is the Base64 encoding of `API_KEY_ID`:`API_KEY_SECRET`
            - **Username**: The API Key ID.
            - **Password**: The API Key Secret.

security:
   - basicAuth: []