Skip to main content
PATCH
/
v1
/
configurations
/
{id}
Edit a configuration
curl --request PATCH \
  --url https://managexrapi.com/v1/configurations/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
  ]
}
'
{
  "data": {
    "id": "sFidGmedeQofSBcvRcyn",
    "name": "Education",
    "registrationCode": "f7GbHvH",
    "deviceCount": 15,
    "deviceExperienceMode": "HOME_SCREEN",
    "vrContent": [
      {
        "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",
        "hidden": false,
        "forceInstall": false,
        "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",
        "sharingOrganizationName": "XR Developer",
        "releaseChannelName": "Production",
        "supportedDeviceModels": [
          "Quest 3",
          "Quest 3S",
          "Pico 4 Ultra Enterprise"
        ]
      }
    ],
    "kioskVrContent": {
      "type": "app",
      "id": {
        "packageName": "<string>",
        "releaseChannel": "<string>",
        "type": "shared"
      }
    },
    "kioskVideoSettings": {
      "loopVideo": true,
      "loopVideoAfterNSecondsHeadsetOff": 30
    },
    "files": [
      {
        "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"
        ]
      }
    ],
    "wifiNetworks": [
      {
        "id": "wifi_abc123",
        "ssid": "MyNetwork",
        "nickname": "Office Wi-Fi",
        "type": "WPA_ENTERPRISE",
        "priorityWifiNetwork": false
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

API key based authentication where is the Base64 encoding of API_KEY_ID:API_KEY_SECRET

  • Username: The API Key ID.
  • Password: The API Key Secret.

Path Parameters

id
string
required

Unique identifier of the configuration

Query Parameters

organizationId
string

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.

Body

application/json
name
string

Updated name for the configuration

Example:

"Client Configuration v2"

vrContent
(App (Release Channel) · object | App (Specific Version) · object | Video · object | WebXR Link · object)[]

Updated set of VR content on the configuration. Content will appear on the Home Screen in the order it appears in the vrContent array.

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

kioskVrContent
App (Release Channel) · object

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)
deviceExperienceMode
enum<string>

Device experience

KIOSK is Kiosk App. Options vary by device type. See supported device information here.

Available options:
HOME_SCREEN,
KIOSK,
KIOSK_VIDEO,
DEFAULT
Example:

"HOME_SCREEN"

kioskModeStrictness
enum<string>

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.

Available options:
DEFAULT,
KIOSK_APP
Example:

"DEFAULT"

confirmMetaDeviceModeChange
boolean

Only required if deviceExperience change impacts Meta Horizon managed services device mode. Supplying the flag confirms that you understand the risks and requirements of the mode change._

Example:

false

wifiNetworkIds
string[]

Unique identifiers of wi-fi networks to deploy on the configuration

priorityWifiNetworkId
string | null

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
object
Example:
{
"id": "DLO133U5NFLMAL1",
"deviceDirectoryPaths": [
"/Android/obb/com.managexr.exampleApp/files"
]
}
timeZone
enum<string>

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).

Available options:
UNMANAGED,
AUTO,
timeZoneId
Example:

"America/New_York"

Response

The updated configuration

data
object

Full representation of a configuration.