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

Parameter
Type
Description
In
Required
applicationId
string

The ID of the required mobile app.

path
required
packageName
string

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

path
required
os
string

The operating system of the required app.

  • ANDROID
  • IOS
  • TVOS
path
required
versionCode
string

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

path
required
versionName
string

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

path
required
content-type
string
-
header
optional
body
string

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
required

Request body objects

The RequestBody object

Response

Response codes

Code
Type
Description
204
-

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

400

Failed. The input is invalid.

413

Failed. The symbol file storage quota is exhausted.

Related topics