Mobile Symbolication API - PUT upload file for an app version

Uploads a symbolication file (dSYM files for iOS or proguard file for Android) for the specified version of a mobile app.

The request consumes one of the following payload types:

  • application/x-compressed
  • application/x-zip-compressed
  • application-zip
  • text-plain

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName}
  • SaaS https://{your-environment-id}{applicationId}/{packageName}/{os}/{versionCode}/{versionName}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName}


To execute this request, you need the Mobile symbolication file management (DssFileManagement) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


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

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 optional


Response codes

Code Description

Success. The file has been uploaded and stored. Response doesn't have a body.


Failed. The input is invalid.


Failed. The symbol file storage quota is exhausted.

Response body

A successful request doesn't return any content.