Update App
Updates an existing application.
Id of the app
Session authentication token.
Detailed record of application.
Url to a icon to use for app. Must start with "https://".
https://myiconUrl.com
Description of the application.
a test app
The permitted domains to send or receive a request from. The field is for the purpose of CORS which set the app specific "ALLOW-ORIGIN-DOMAINS" header in HTTP.
mydomain.com
List of application permissions provisioned for the application. In addition to the known ones, custom permissions are accepted. A custom permission should only contain upper case alphanumeric characters and underscore. It should not be empty or only contain spaces and its length is limited to 64 characters.
Known permissions:
- SEND_MESSAGES
- GET_USER_CONNECTIONS
- REQUEST_USER_CONNECTIONS
- SET_PRESENCE
- GET_PRESENCE
- GET_BASIC_USER_INFO
- GET_EXTENDED_USER_INFO
- GET_BASIC_CONTACT_INFO
- GET_EXTENDED_CONTACT_INFO
- ACT_AS_USER
- MANAGE_SIGNALS
- MANAGE_USER_FOLLOWING
- TRUST_APP
["ACT_AS_USER","SEND_MESSAGES"]
The app public certificate in pem format.
-----BEGIN PUBLIC KEY-----\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\n-----END PUBLIC KEY-----
POST /pod/v1/admin/app/{id}/update HTTP/1.1
Host: yourpodURL.symphony.com
sessionToken: text
Content-Type: application/json
Accept: */*
Content-Length: 866
{
"applicationInfo": {
"appId": "my-test-app",
"name": "my-test-app",
"appUrl": "https://joe.mydomain.com",
"domain": "mydomain.com",
"publisher": "Joe Smith"
},
"iconUrl": "https://myiconUrl.com",
"description": "a test app",
"allowOrigins": "mydomain.com",
"permissions": [
"ACT_AS_USER",
"SEND_MESSAGES"
],
"cert": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"authenticationKeys": {
"current": {
"key": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"expirationDate": 1700815176000,
"action": "SAVE"
},
"previous": {
"key": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"expirationDate": 1700815176000,
"action": "SAVE"
}
},
"notification": {
"url": "https://some.url",
"apiKey": "test123456"
},
"properties": [
{
"key": "port",
"value": 4000
},
{
"key": "url",
"value": "https://someother.url"
}
]
}
{
"applicationInfo": {
"appId": "my-test-app",
"name": "my-test-app",
"appUrl": "https://joe.mydomain.com",
"domain": "mydomain.com",
"publisher": "Joe Smith"
},
"iconUrl": "https://myiconUrl.com",
"description": "a test app",
"allowOrigins": "mydomain.com",
"permissions": [
"ACT_AS_USER",
"SEND_MESSAGES"
],
"cert": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"authenticationKeys": {
"current": {
"key": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"expirationDate": 1700815176000,
"action": "SAVE"
},
"previous": {
"key": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
"expirationDate": 1700815176000,
"action": "SAVE"
}
},
"notification": {
"url": "https://some.url",
"apiKey": "test123456"
},
"properties": [
{
"key": "port",
"value": 4000
},
{
"key": "url",
"value": "https://someother.url"
}
]
}
📘 RSA Application AuthenticationFor more information on how to authenticate an application using RSA, refer to App Authentication.
🚧 Roles and PrivilegesCalling this endpoint requires the Super Administrator, Super Compliance Officer or User Provisioning role. See Bot Permissions for a list of roles and associated privileges.
Last updated
Was this helpful?