Try it free

Pin or unpin a React Native mapping file

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Pin or unpin a React Native source mapping file in Dynatrace symbol file storage with the Deobfuscation API to protect it from automatic deletion.

PUTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/rum/deobfuscation/v1/symbol-files/rn/{dtRumAppId}/{bundleName}/{platform}/{fileName}/{bundleVersion}/pinned

Overview

You use this operation to change the pinned state of a React Native mapping file in symbol file storage. A pinned file is protected from automatic deletion. The dtRumAppId, bundleName, platform, fileName, and bundleVersion path parameters identify the file, for example a release you need to keep debuggable.

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
dtRumAppIdstring

RUM application identifier the bundle belongs to.

pathRequired
bundleNamestring

Name of the React Native bundle.

pathRequired
platformstring

Platform the bundle is built for.

The element can hold these values
  • IOS
  • ANDROID
pathRequired
fileNamestring

Name of the bundle file the mapping refers to.

pathRequired
bundleVersionstring

Version of the React Native bundle.

pathRequired
bodyPinRnSymbolFileRequest

Request body for pinning or unpinning a React Native symbol file.

bodyRequired

Request body objects

The PinRnSymbolFileRequest object

Request body for pinning or unpinning a React Native symbol file.

ElementTypeDescriptionRequired
pinnedboolean

Whether to pin the symbol file and protect it from automatic deletion.

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.

{
"pinned": true
}

Response

Response codes

CodeTypeDescription
200RnSymbolFileInfoMetadata

Symbol file pinned state updated successfully.

400--
401--
403--
404--
500--
501--
503--

Response body objects

The RnSymbolFileInfoMetadata object

Metadata associated with a React Native symbol file.

ElementTypeDescription
pinnedboolean

Indicates whether the symbol file is pinned and protected from automatic deletion.

storedSizeInBytesstring

The size of the stored symbol file in bytes.

uploadTimestampInMillisecondsstring

The timestamp of when the symbol file was uploaded, in milliseconds since epoch.

Response body JSON models

{
"pinned": true,
"storedSizeInBytes": "string",
"uploadTimestampInMilliseconds": "string"
}
Related tags
Platform APIDynatrace Platform