Pin or unpin a JavaScript source mapping 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/js/{fileType}/pinned |
You use this operation to change the pinned state of a JavaScript mapping file in symbol file storage. A pinned file is protected from automatic deletion. The fileType path parameter and the minifiedJsFileUrl query parameter identify the file, and the pinned field of the request body sets the new state.
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 |
|---|---|---|---|---|
| fileType | string | Type of the JavaScript file the mapping belongs to. The element can hold these values
| path | Required |
| minifiedJsFileUrl | string | URL of the minified JavaScript file whose mapping should be pinned or unpinned. | query | Required |
| body | Pin | Request body for pinning or unpinning a JavaScript mapping file. | body | Required |
PinJsSymbolFileRequest objectRequest body for pinning or unpinning a JavaScript mapping 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 | Type | Description |
|---|---|---|
| 200 | Js | Symbol file pinned state updated successfully. |
| 400 | - | - |
| 401 | - | - |
| 403 | - | - |
| 404 | - | - |
| 500 | - | - |
| 501 | - | - |
| 503 | - | - |
JsMappingFile objectJavaScript mapping file information.
| Element | Type | Description |
|---|---|---|
| fileName | string | The file name of the JavaScript mapping file. |
| fileType | string | The type of the JavaScript file (e.g. MINIFIED, SOURCE, SOURCEMAP). |
| minifiedJsFileUrl | string | The URL of the minified JavaScript file this mapping belongs to. |
| numberOfFiles | integer | The number of files associated with this mapping entry. |
| pinned | boolean | Indicates whether the mapping file is pinned and protected from automatic deletion. |
| size | string | The size of the stored mapping file in bytes. |
| uploadTimestamp | string | The timestamp of when the mapping file was uploaded, in milliseconds since epoch. |
| zipped | boolean | Indicates whether the mapping file is stored in a zipped format. |
{"fileName": "string","fileType": "string","minifiedJsFileUrl": "string","numberOfFiles": 1,"pinned": true,"size": "string","uploadTimestamp": "string","zipped": true}