Get App

Gets an existing application.

Gets a app

GETyourpodURL.symphony.com/pod/v1/admin/app/{id}/get

Path parameters

id*string

the id of the app to get

Header parameters

Response

200400401403500

OK

Body

application/json

applicationInfoApplicationInfo (object)

Required information for creating an application.

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"

permissionsarray of string

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

certstring

The app public certificate in pem format.

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

authenticationKeysAppAuthenticationKeys (object)

App RSA keys information.

notificationAppNotification (object)

Application callback information

propertiesAppProperties (array of AppProperty (object))

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

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/admin/app/{id}/get', {
    method: 'GET',
    headers: {
      "sessionToken": "text"
    },
});
const data = await response.json();

Response

200400401403500

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

🚧 Roles and Privileges

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