Try it free

Upload a mobile symbol file

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Upload an Android, iOS, or tvOS symbol file to Dynatrace symbol file storage with the Deobfuscation API for a specific app, package, and version.

PUTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/rum/deobfuscation/v1/symbol-files/mobile/{platform}/{dtRumAppId}/{packageName}/{versionCode}/{versionName}

Overview

You use this operation to upload a mobile symbol file to symbol file storage. The platform, dtRumAppId, packageName, versionCode, and versionName path parameters identify the app version the file belongs to, and the accepted content types depend on the platform, such as plain text or a zip archive for Android.

Authentication

To execute this request, you need a platform token or OAuth access token with deobfuscation:symbol-files:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
platformstring

Mobile platform of the symbol file.

The element can hold these values
  • ANDROID
  • IOS
  • TVOS
pathRequired
dtRumAppIdstring

RUM application identifier the symbol file belongs to.

pathRequired
packageNamestring

Unique identifier of the mobile application across versions.

  • Android: the application id declared in build.gradle (applicationId) / the manifest package attribute, e.g. com.example.app.
  • iOS / tvOS: the bundle identifier from Info.plist (CFBundleIdentifier), e.g. com.example.app.
pathRequired
versionCodestring

Internal, monotonically increasing build identifier of the specific application build the symbol file was produced for. Two builds of the same app may share a versionName but must have different versionCode values.

  • Android: the versionCode from the manifest (android:versionCode), e.g. 1317.
  • iOS / tvOS: the build number from Info.plist (CFBundleVersion), e.g. 42.
pathRequired
versionNamestring

User-facing version string of the application (the value shown to end users in the app store).

  • Android: versionName from the manifest (android:versionName), e.g. 11.0.151.
  • iOS / tvOS: the short version string from Info.plist (CFBundleShortVersionString), e.g. 11.0.151.
pathRequired
bodyobject-bodyRequired

Request body objects

The RequestBody object

ElementTypeDescriptionRequired
filestring

The symbol file content. For Android, this is a ProGuard/R8 mapping.txt or a zip archive containing it. For iOS/tvOS, this is a zip archive containing the dSYM bundle. Maximum allowed size is 100 MB.

Required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"file": "string"
}

Response

Response codes

CodeDescription
200

Symbol file uploaded successfully.

400-
401-
403-
404-
413-
415-
500-
501-
503-
Related tags
Platform APIDynatrace Platform