Update App

Updates an existing application.

Updates a app

post

/v1/admin/app/{id}/update

Path parameters

idstringrequired

Id of the app

Header parameters

sessionTokenstringrequired

Session authentication token.

Body

applicationInfoobject

Required information for creating an application.

Example: {"appId":"my-test-app","name":"my-test-app","appUrl":"https://joe.mydomain.com","domain":"mydomain.com","publisher":"Joe Smith"}

iconUrlstring

Url to a icon to use for app. Must start with "https://".

Example: https://myiconUrl.com

descriptionstring

Description of the application.

Example: a test app

allowOriginsstring

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.

Example: mydomain.com

certstring

The app public certificate in pem format.

Example: -----BEGIN PUBLIC KEY-----\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\n-----END PUBLIC KEY-----

authenticationKeysobject

App RSA keys information.

notificationobject

Application callback information

propertiesobject[]

Application configuration properties that are shared with the extension application, client side. Do not store sensitive information here. Since SBE 20.14.

Example: [{"key":"port","value":4000},{"key":"url","value":"https://someother.url"}]

permissionsstring · min: 1 · max: 64[]

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

Example: ["ACT_AS_USER","SEND_MESSAGES"]

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/admin/app/{id}/update' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '{"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","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"}],"permissions":["ACT_AS_USER","SEND_MESSAGES"]}'

200

400

401

403

500

200

{
  "description": "a test app",
  "allowOrigins": "mydomain.com",
  "cert": "-----BEGIN PUBLIC KEY-----\\nMIICIANBgkqhw0BAQ...cCAwEAAQ==\\n-----END PUBLIC KEY-----",
  "authenticationKeys": null,
  "permissions": [
    "ACT_AS_USER",
    "SEND_MESSAGES"
  ],
  "applicationInfo": {
    "appId": "my-test-app",
    "name": "my-test-app",
    "appUrl": "https://joe.mydomain.com",
    "domain": "mydomain.com",
    "publisher": "Joe Smith"
  },
  "notification": {
    "url": "https://some.url",
    "apiKey": 123456
  },
  "properties": [
    {
      "key": "port",
      "value": 4000
    },
    {
      "key": "url",
      "value": "https://someother.url"
    }
  ]
}

OK

📘 RSA Application Authentication

For more information on how to authenticate an application using RSA, refer to App Authentication.

🚧 Roles and Privileges

Calling this endpoint requires the Super Administrator, Super Compliance Officer or User Provisioning role. See Bot Permissions for a list of roles and associated privileges.