Configurations
Edit Configuration
Getting Started
Devices
Configurations
App Versions & Release Channels
Organizations
Configurations
Edit Configuration
Update an existing configuration to change the content deployed (e.g., update app versions, add/remove apps, videos, and webxr links)
PATCH
/
v1
/
configurations
/
{id}
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"
}
}
}
]
}'
{
"data": {
"id": "sFidGmedeQofSBcvRcyn",
"name": "Client Configuration v2",
"registrationCode": "ad39kda",
"deviceCount": 12,
"deviceExperience": "HOME_SCREEN",
"content": [
{
"contentType": "app",
"id": "com.my.customApp",
"title": "Custom App",
"iconUrl": "https://storage.example.com/apps/com.my.customApp/icon.png",
"createdAt": 1719855774748,
"updatedAt": 1719855779899,
"type": "managed",
"versionCode": 17,
"versionName": "2.3.0",
"releaseChannelName": "prod",
"apkSize": 1204975930,
"obbSize": 0,
"selfHosted": false,
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
},
{
"contentType": "video",
"id": "KSJ34KHDA12MR",
"title": "Onboarding Intro",
"iconUrl": "https://storage.example.com/videos/onboarding-intro/icon.jpg",
"size": 553657,
"type": "_360",
"display": "MONO",
"mapping": "EQUIRECTANGULAR",
"packing": "NONE",
"md5": "abc123xyz456==",
"createdAt": 1719840000000,
"updatedAt": 1719849999999
},
{
"contentType": "app",
"id": "com.my.test1",
"title": "Test App",
"iconUrl": "https://storage.example.com/apps/com.my.test1/icon.png",
"createdAt": 1719850000000,
"updatedAt": 1719857777777,
"type": "managed",
"versionCode": 22,
"versionName": "3.0.0",
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
},
{
"contentType": "app",
"id": "com.my.test1",
"title": "Test App",
"iconUrl": "https://storage.example.com/apps/com.my.test1/icon.png",
"createdAt": 1719800000000,
"updatedAt": 1719851111111,
"type": "managed",
"versionCode": 1,
"versionName": "1.0",
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
}
],
"files": [],
"wifiNetworks": []
}
}
Authorizations
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.
Path Parameters
Unique identifier of the configuration
Query Parameters
Unique identifier of the organization. Defaults to the organization associated with the API key if no id supplied.
Body
application/json
Response
200 - application/json
The updated configuration
The response is of type object
.
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"
}
}
}
]
}'
{
"data": {
"id": "sFidGmedeQofSBcvRcyn",
"name": "Client Configuration v2",
"registrationCode": "ad39kda",
"deviceCount": 12,
"deviceExperience": "HOME_SCREEN",
"content": [
{
"contentType": "app",
"id": "com.my.customApp",
"title": "Custom App",
"iconUrl": "https://storage.example.com/apps/com.my.customApp/icon.png",
"createdAt": 1719855774748,
"updatedAt": 1719855779899,
"type": "managed",
"versionCode": 17,
"versionName": "2.3.0",
"releaseChannelName": "prod",
"apkSize": 1204975930,
"obbSize": 0,
"selfHosted": false,
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
},
{
"contentType": "video",
"id": "KSJ34KHDA12MR",
"title": "Onboarding Intro",
"iconUrl": "https://storage.example.com/videos/onboarding-intro/icon.jpg",
"size": 553657,
"type": "_360",
"display": "MONO",
"mapping": "EQUIRECTANGULAR",
"packing": "NONE",
"md5": "abc123xyz456==",
"createdAt": 1719840000000,
"updatedAt": 1719849999999
},
{
"contentType": "app",
"id": "com.my.test1",
"title": "Test App",
"iconUrl": "https://storage.example.com/apps/com.my.test1/icon.png",
"createdAt": 1719850000000,
"updatedAt": 1719857777777,
"type": "managed",
"versionCode": 22,
"versionName": "3.0.0",
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
},
{
"contentType": "app",
"id": "com.my.test1",
"title": "Test App",
"iconUrl": "https://storage.example.com/apps/com.my.test1/icon.png",
"createdAt": 1719800000000,
"updatedAt": 1719851111111,
"type": "managed",
"versionCode": 1,
"versionName": "1.0",
"configurationDeployments": {
"sFidGmedeQofSBcvRcyn": 12
}
}
],
"files": [],
"wifiNetworks": []
}
}