Mobile Symbolication API - PUT upload file for an app version
Uploads a symbol 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.
- Note that you can upload symbol files up to 100 MiB.
The request consumes one of the following payload types:
application/x-compressedapplication/x-zip-compressedapplication/ziptext/plain
| PUT | ManagedDynatrace for Government | 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 an access token with DssFileManagement scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| applicationId | string | The ID of the required mobile app. | path | required |
| packageName | string | The CFBundleIdentifier (iOS) or the package name (Android) of the required mobile app. | path | required |
| os | string | The operating system of the required app. | path | required |
| versionCode | string | The version code (Android) / CFBundleVersion (iOS) of the required app. | path | required |
| versionName | string | The version name (Android) / CFBundleShortVersionString (iOS) of the required app. | 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 |
Request body objects
The RequestBody object
The object doesn't provide any parameters.
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 204 | Success. The file has been uploaded and stored. Response doesn't have a body. | |
| 400 | ErrorEnvelope | Failed. The input is invalid. |
| 413 | ErrorEnvelope | Failed. The symbol file storage quota is exhausted. |