Mobile Symbolication API - PUT upload file for an app version
Uploads a symbolication file (Android mapping file or iOS symbol extract file) for the specified version of a mobile app.
For iOS apps, you must preprocess the dSYM files via the DSSClient before transferring them to Dynatrace. For more details, see Upload symbol files via REST API.
The request consumes one of the following payload types:
application/x-compressedapplication/x-zip-compressedapplication-ziptext-plain
| PUT | 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 of the app this file belongs to | path | required |
| packageName | string | The CFBundleIdentifier (iOS) or the package name (Android) which identifies the app associated with the uploaded file | path | required |
| os | string | The operating system the file belongs to | path | required |
| versionCode | string | The version code (Android) / CFBundleVersion (iOS) the file belongs to | path | required |
| versionName | string | The version name (Android) / CFBundleShortVersionString (iOS) the file belongs to | path | required |
| content-type | string | - | header | optional |
| body | string | The file to be uploaded. A proguard file (*.txt) for Android or the zip file produced by the DTXDssClient provided with the OneAgent for iOS. | body | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. The file has been uploaded and stored. Response doesn't have a body. |
| 400 | Error | Failed. The input is invalid. |
| 413 | Error | Failed. The symbol file storage quota is exhausted. |