Mobile Symbolication API - PUT upload file for an app version

  • Reference

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.

  • You can upload a symbol file in any supported format (compressed or uncompressed). Note the following limits:

    • Uploaded file—must not exceed 100 MiB.

    • Uncompressed file—must not exceed 500 MiB after decompression (if compressed).

    If your file is too large, try compressing it to stay within the 100 MiB upload limit.

The request consumes one of the following payload types:

  • application/x-compressed
  • application/x-zip-compressed
  • application/zip
  • text/plain
PUTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/config/v1/symfiles/{applicationId}/{packageName}/{os}/{versionCode}/{versionName}
Environment ActiveGatehttps://{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

ParameterTypeDescriptionInRequired
applicationIdstring

The UUID of the required mobile or custom application. It can be found in the Instrumentation Wizard of your 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.