Update App

Updates an existing application.

Updates a app

post
Path parameters
idanyrequired

Id of the app

Header parameters
sessionTokenanyrequired

Session authentication token.

Body

Detailed record of application.

applicationInfoobjectoptional

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"}

iconUrlstringoptional

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

Example: https://myiconUrl.com
descriptionstringoptional

Description of the application.

Example: a test app
allowOriginsstringoptional

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
permissionsstring[]optional

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"]
certstringoptional

The app public certificate in pem format.

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

App RSA keys information.

notificationobjectoptional

Application callback information

propertiesobject[]optional

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"}]

Responses
curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/admin/app/{id}/update' \
  --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",
    "permissions": [
      "ACT_AS_USER",
      "SEND_MESSAGES"
    ],
    "cert": "-----BEGIN PUBLIC KEY-----\
  MIICIANBgkqhw0BAQ...cCAwEAAQ==\
  -----END PUBLIC KEY-----",
    "authenticationKeys": {
      "current": {
        "key": "-----BEGIN PUBLIC KEY-----\
  MIICIANBgkqhw0BAQ...cCAwEAAQ==\
  -----END PUBLIC KEY-----",
        "expirationDate": 1700815176000,
        "action": "SAVE"
      },
      "previous": {
        "key": "-----BEGIN PUBLIC KEY-----\
  MIICIANBgkqhw0BAQ...cCAwEAAQ==\
  -----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"
    }
  ]
}

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.

Last updated

Was this helpful?