---
title: "Restore source maps"
method: PATCH
path: "/api/v2/sourcemaps/restore"
tags: ["RUM"]
---

# Restore source maps

`PATCH /api/v2/sourcemaps/restore`

Restores previously deleted source maps matching the specified filter
criteria. Supports dry-run mode to preview which source maps would be
restored without performing the actual restoration.

## Query parameters

- `mapkind` 'js' | 'jvm' | 'ios' | 'react' | 'flutter' | 'elf' | 'ndk' | 'il2cpp', required — The type of source map.
- `dry_run` boolean, required
- `filter[service]` string[]
- `filter[version]` string[]
- `filter[variant]` string[]
- `filter[id]` string[]
- `filter[build_id]` string[]
- `filter[uuid]` string[]
- `filter[platform]` string[]
- `filter[build_number]` string[]
- `filter[bundle_name]` string[]
- `filter[arch]` string[]
- `filter[symbol_source]` string[]
- `filter[origin]` string[]
- `filter[origin_version]` string[]
- `filter[filename]` string
- `filter[debug_id]` string
- `filter[gnu_build_id]` string
- `filter[go_build_id]` string
- `filter[file_hash]` string

## Response `200`

OK

- SourcemapsResponse — Response containing a list of affected source maps.
  - `data` SourcemapItem[], required — List of source map data objects.
    - union — A source map data object representing one of the supported map kinds.
      - JSSourcemapData — JavaScript source map data object.
        - `attributes` JSSourcemapAttributes, required — Attributes of a JavaScript source map.
          - `absolute_path` string — The absolute path to the minified JavaScript file.
          - `blob_storage_sourcemap_path` string — The path to the source map in blob storage.
          - `build_id` string — The build identifier.
          - `created_at` string, date-time, required — The timestamp when the source map was created.
          - `domain` string — The domain associated with the source map.
          - `file_name` string — The file name of the minified JavaScript file.
          - `mapkind` string, required — The type of source map.
          - `service` string — The service name associated with the source map.
          - `size` integer, required — The size of the source map file in bytes.
          - `variant` string — The source map variant.
          - `version` string — The version of the service associated with the source map.
          - `version_code` string — The version code.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - ReactNativeSourcemapData — React Native source map data object.
        - `attributes` ReactNativeSourcemapAttributes, required — Attributes of a React Native source map.
          - `build_number` string — The build number.
          - `bundle_name` string — The bundle name.
          - `bundle_version` string — The bundle version.
          - `created_at` string, date-time, required — The timestamp when the source map was created.
          - `debug_id` string — The debug identifier (UUID format).
          - `mapkind` string, required — The type of source map.
          - `platform` string — The platform the source map was built for (e.g., `ios`, `android`).
          - `service` string — The service name associated with the source map.
          - `size` integer, required — The size of the source map file in bytes.
          - `version` string — The version of the service associated with the source map.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - IOSSourcemapData — iOS dSYM source map data object.
        - `attributes` IOSSourcemapAttributes, required — Attributes of an iOS dSYM source map.
          - `created_at` string, date-time, required — The timestamp when the source map was created.
          - `mapkind` string, required — The type of source map.
          - `size` integer, required — The size of the dSYM file in bytes.
          - `uuids` string — The UUID(s) associated with the dSYM file.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - JVMSourcemapData — JVM (ProGuard/R8) mapping file data object.
        - `attributes` JVMSourcemapAttributes, required — Attributes of a JVM mapping file.
          - `build_id` string — The build identifier (UUID format).
          - `created_at` string, date-time, required — The timestamp when the mapping file was created.
          - `mapkind` string, required — The type of source map.
          - `service` string — The service name associated with the mapping file.
          - `size` integer, required — The size of the mapping file in bytes.
          - `variant` string — The build variant (e.g., `release`, `debug`).
          - `version` string — The version of the service associated with the mapping file.
          - `version_code` string — The version code.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - FlutterSourcemapData — Flutter symbol file data object.
        - `attributes` FlutterSourcemapAttributes, required — Attributes of a Flutter symbol file.
          - `arch` string — The target CPU architecture.
          - `created_at` string, date-time, required — The timestamp when the symbol file was created.
          - `mapkind` string, required — The type of source map.
          - `service` string — The service name associated with the symbol file.
          - `size` integer, required — The size of the symbol file in bytes.
          - `variant` string — The build variant.
          - `version` string — The version of the service associated with the symbol file.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - ELFSourcemapData — ELF symbol file data object.
        - `attributes` ELFSourcemapAttributes, required — Attributes of an ELF symbol file.
          - `arch` string — The target CPU architecture.
          - `created_at` string, date-time, required — The timestamp when the symbol file was created.
          - `file_hash` string — The SHA256 hash of the ELF file.
          - `file_name` string — The ELF file name.
          - `gnu_build_id` string — The GNU build ID (UUID format).
          - `go_build_id` string — The Go build ID (UUID format).
          - `mapkind` string, required — The type of source map.
          - `origin` string — The origin of the ELF file.
          - `origin_version` string — The version of the origin package.
          - `size` integer, required — The size of the ELF file in bytes.
          - `symbol_source` string — The source of the debug symbols.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - NDKSourcemapData — Android NDK symbol file data object.
        - `attributes` NDKSourcemapAttributes, required — Attributes of an Android NDK symbol file.
          - `arch` string — The target CPU architecture.
          - `build_id` string — The build identifier (UUID format).
          - `created_at` string, date-time, required — The timestamp when the symbol file was created.
          - `file_name` string — The NDK library file name.
          - `mapkind` string, required — The type of source map.
          - `size` integer, required — The size of the symbol file in bytes.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.
      - IL2CPPSourcemapData — IL2CPP mapping file data object.
        - `attributes` IL2CPPSourcemapAttributes, required — Attributes of an IL2CPP mapping file.
          - `build_id` string — The build identifier (UUID format).
          - `created_at` string, date-time, required — The timestamp when the mapping file was created.
          - `mapkind` string, required — The type of source map.
          - `size` integer, required — The size of the mapping file in bytes.
        - `id` string, required — The unique identifier of the source map.
        - `type` 'sourcemaps', required — The resource type for source map objects.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too many requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)
