• Home
  • Dynatrace API
  • Configuration
  • Mobile Deobfuscation and Symbolication
  • PUT upload file for an app version

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-compressed
  • application/x-zip-compressed
  • application-zip
  • text-plain
PUTManaged 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 Mobile symbolication file management (DssFileManagement) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
applicationIdstring

The application id used in Dynatrace of the app this file belongs to

pathrequired
packageNamestring

The CFBundleIdentifier (iOS) or the package name (Android) which identifies the app associated with the uploaded file

pathrequired
osstring

The operating system the file belongs to

The element can hold these values
  • ANDROID
  • IOS
  • TVOS
pathrequired
versionCodestring

The version code (Android) / CFBundleVersion (iOS) the file belongs to

pathrequired
versionNamestring

The version name (Android) / CFBundleShortVersionString (iOS) the file belongs to

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

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.

Related topics
  • Upload and manage symbol files for mobile applications

    Learn about deobfuscation (Android) and symbolication (iOS) and your options for uploading and managing symbol files in Dynatrace.