Mobile Symbolication API - PUT upload file for an app version

Uploads a symbol file (Android mapping file and iOS/tvOS 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 a symbol file of up to 100 MiB compressed; the uncompressed file must not exceed 500 MiB.

The request consumes one of the following payload types:

  • application/x-compressed
  • application/x-zip-compressed
  • application/zip
  • text/plain
PUTSaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName}
Environment ActiveGatehttps://{your-activegate-domain}:9999/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

ParameterTypeDescriptionInRequired
applicationIdstring

The ID of the required mobile app.

pathrequired
packageNamestring

The CFBundleIdentifier (iOS) or the package name (Android) of the required mobile app.

pathrequired
osstring

The operating system of the required app.

  • ANDROID
  • IOS
  • TVOS
pathrequired
versionCodestring

The version code (Android) / CFBundleVersion (iOS) of the required app.

pathrequired
versionNamestring

The version name (Android) / CFBundleShortVersionString (iOS) of the required app.

pathrequired
content-typestring-headeroptional
bodystring

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.

bodyrequired

Request body objects

The RequestBody object

Response

Response codes

CodeTypeDescription
204-

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

400ErrorEnvelope

Failed. The input is invalid.

413ErrorEnvelope

Failed. The symbol file storage quota is exhausted.