Pin or unpin an Android, iOS, or tvOS symbol file in Dynatrace symbol file storage with the Deobfuscation API to protect it from automatic deletion.
| PUT | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/rum/deobfuscation/v1/symbol-files/mobile/{platform}/{dtRumAppId}/{packageName}/{versionCode}/{versionName}/pinned |
You use this operation to change the pinned state of a mobile symbol file in symbol file storage. A pinned file is protected from automatic deletion. The platform, dtRumAppId, packageName, versionCode, and versionName path parameters identify the file, for example a release you need to keep debuggable.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| platform | string | Mobile platform of the symbol file. The element can hold these values
| path | Required |
| dtRumAppId | string | RUM application identifier the symbol file belongs to. | path | Required |
| packageName | string | Unique identifier of the mobile application across versions.
| path | Required |
| versionCode | string | 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
| path | Required |
| versionName | string | User-facing version string of the application (the value shown to end users in the app store).
| path | Required |
| body | Pin | Request body for pinning or unpinning a mobile symbol file. | body | Required |
PinMobileSymbolFileRequest objectRequest body for pinning or unpinning a mobile symbol file.
| Element | Type | Description | Required |
|---|---|---|---|
| pinned | boolean | Whether to pin the symbol file and protect it from automatic deletion. | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"pinned": true}
| Code | Description |
|---|---|
| 200 | Symbol file pinned state updated successfully. |
| 400 | - |
| 401 | - |
| 403 | - |
| 404 | - |
| 500 | - |
| 501 | - |
| 503 | - |