Mobile Symbolication API - GET files for an app version
Gets the metadata of the symbolication file belonging to the specified app version. Only one symbolication file can exist per OS and version.
The request produces an application/json payload.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName} |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName} | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName} |
Authentication
To execute this request, you need Mobile symbolication file management (DssFileManagement) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| applicationId | string | The application id used in Dynatrace for the mobile application to be queried | path | required |
| packageName | string | The CFBundleIdentifier (iOS) or the package name (Android) which identifies the app to be queried | path | required |
| os | string | The operating system for which the file should be displayed. | path | required |
| versionCode | string | The version code (Android) / CFBundleVersion (iOS) of the file to be retrieved | path | required |
| versionName | string | The version name (Android) / CFBundleShortVersionString (iOS) of the file to be retrieved | path | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Symbol | Success |
Response body objects
The SymbolFile object
| Element | Type | Description | Required |
|---|---|---|---|
| applicationName | string | The name of the application this file belongs to | optional |
| size | integer | The size of the file in KB | optional |
| appId | App | The appId, the app version and the bundle id which uniquely identify the app | optional |
| uploadTimestamp | integer | The timestamp of the upload time of the file, in UTC milliseconds | optional |
| pinned | boolean | Is the file pinned and therefore cannot be deleted. | optional |
The AppIdentifier object
The appId, the app version and the bundle id which uniquely identify the app
| Element | Type | Description | Required |
|---|---|---|---|
| id | string | The id where the file belongs to | optional |
| versionCode | string | The version code (Android) / bundle version (iOS) the file belongs to | required |
| versionName | string | The version name (Android) / bundle versions string (iOS) the file belongs to | required |
| packageName | string | The bundleId (iOS) or package name (Android) the file belongs to | optional |
| os | string | The operating system where the file belongs to | optional |
Response body JSON model
{
"applicationName": "string",
"size": 1,
"appId": {
"id": "string",
"versionCode": "string",
"versionName": "string",
"packageName": "string",
"os": "ANDROID"
},
"uploadTimestamp": 1,
"pinned": true
}