Update Application with an RSA Public Key

Released in 1.53
Updates an existing application with an RSA public key.

Request Examples

This example replaces the current key with the new value. The previous key becomes "previous" and has now an expirationDate (72 hours, server time).

curl -X POST \
  https://acme.symphony.com/pod/v1/admin/app/my-test-app/update \
  -H 'content-type: application/json' \
  -H 'sessiontoken: YOUR_SESSION_TOKEN' \
  -d '{
    "applicationInfo": {
      "appId": "my-test-app",
      "name": "my-test-app",
      "appUrl": "https://jeremy.mydomain.com",
      "domain": "mydomain.com",
      "publisher": "Jeremy Passeron"
    },
    "description": "a test app",
    "allowOrigins": "mydomain.com",
    "permissions": ["ACT_AS_USER", "SEND_MESSAGES"],
    "notification": {
        "url": "https://some.url",
        "apiKey":"123456"
    },
    "authenticationKeys": {
    "current": {
       "action":"SAVE",
       "key":"-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0....YOUR_NEW_KEY...cCAwEAAQ==\n-----END PUBLIC KEY-----"
    }
   }
 }'
This example shows extendes the  key

curl -X POST \
  https://POD_URL/pod/v1/admin/app/my-test-app/update \
  -H 'content-type: application/json' \
  -H 'sessiontoken: YOUR_SESSION_TOKEN' \
  -d '{
    "applicationInfo": {
      "appId": "my-test-app",
      "name": "my-test-app",
      "appUrl": "https://jeremy.mydomain.com",
      "domain": "mydomain.com",
      "publisher": "Jeremy Passeron"
    },
    "description": "a test app",
    "allowOrigins": "mydomain.com",
    "permissions": ["ACT_AS_USER", "SEND_MESSAGES"],
    "notification": {
       "url": "https://some.url",
       "apiKey":"mySecretApiKey123!"
    },
    "authenticationKeys": {
      "previous": {
      "action":"EXTEND"
    }
   }
 }'
This example shows revoking the current authentication key

curl -X POST \
  https://POD_URL/pod/v1/admin/app/my-test-app/update \
  -H 'content-type: application/json' \
  -H 'sessiontoken: YOUR_SESSION_TOKEN' \
  -d '{
    "applicationInfo": {
      "appId": "my-test-app",
      "name": "my-test-app",
      "appUrl": "https://jeremy.mydomain.com",
      "domain": "mydomain.com",
      "publisher": "Jeremy Passeron"
    },
    "description": "a test app",
    "allowOrigins": "mydomain.com",
    "permissions": ["ACT_AS_USER", "SEND_MESSAGES"],
    "notification": {
       "url": "https://some.url",
       "apiKey":"mySecretApiKey123!"
    },
    "authenticationKeys": {
      "current": {
      "action":"REVOKE"
    }
  }
}'
This will remove the app previous key.

curl -X POST \
  https://POD_URL/pod/v1/admin/app/my-test-app/update \
  -H 'content-type: application/json' \
  -H 'sessiontoken: YOUR_SESSION_TOKEN' \
  -d '{
    "applicationInfo": {
      "appId": "my-test-app",
      "name": "my-test-app",
      "appUrl": "https://jeremy.mydomain.com",
      "domain": "mydomain.com",
      "publisher": "Jeremy Passeron"
    },
    "description": "a test app",
    "allowOrigins": "mydomain.com",
    "permissions": ["ACT_AS_USER", "SEND_MESSAGES"],
    "notification": {
       "url": "https://some.url",
       "apiKey":"mySecretApiKey123!"
    },
    "authenticationKeys": {
      "previous": {
      "action":"REVOKE"
    }
  }
}'

📘

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 following roles: Super Administrator, Super Compliance Officer or User Provisioning.
See Bot Permissions for a list of roles and associated privileges.

Language