For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/api/latest/rum/get-a-javascript-source-map.md. A documentation index is available at /llms.txt.

Get a JavaScript source map

Note: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.

GET https://api.ap1.datadoghq.com/api/v2/sourcemapshttps://api.ap2.datadoghq.com/api/v2/sourcemapshttps://api.datadoghq.eu/api/v2/sourcemapshttps://api.ddog-gov.com/api/v2/sourcemapshttps://api.us2.ddog-gov.com/api/v2/sourcemapshttps://api.uk1.datadoghq.com/api/v2/sourcemapshttps://api.datadoghq.com/api/v2/sourcemapshttps://api.us3.datadoghq.com/api/v2/sourcemapshttps://api.us5.datadoghq.com/api/v2/sourcemaps

Overview

Retrieves the content of a specific JavaScript source map file. Provide either debug_id with a UUID, or all three of filename, service, and version. When debug_id is provided, filename, service, and version are not required and are ignored.

Examples: the following commands use the US1 API host. Replace the host with the API host for your site, and the filename, service, version, and debug ID with values from your organization. Use --get so curl sends the parameters in the query string.

1. Retrieve a source map by debug ID

Provide debug_id with a UUID. No filename, service, or version is required.

curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
  --data-urlencode "debug_id=00000000-0000-4000-8000-000000000001"

2. Retrieve a source map by service and version

Provide filename together with service and version.

curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
  --data-urlencode "filename=js/bundle.min.js.map" \
  --data-urlencode "service=my-web-service" \
  --data-urlencode "version=1.0.0"
This endpoint requires the rum_apps_read permission.

Arguments

Query Strings

Name

Type

Description

debug_id

string

The debug ID of the JavaScript source map, in UUID format. When provided, filename, service, and version are not required and are ignored.

filename

string

The path to the source map file. Required when debug_id is omitted.

service

string

The service name associated with the source map. Required when debug_id is omitted.

version

string

The version of the service associated with the source map. Required when debug_id is omitted.

Response

OK

Response containing a JavaScript source map file.

Expand All

Field

Type

Description

data [required]

object

JavaScript source map file data object.

attributes [required]

object

Attributes of a JavaScript source map file.

file [required]

string

The name of the minified JavaScript file.

mappings [required]

string

The Base64 VLQ encoded string that maps positions in the minified file to positions in the original source files.

minifiedLineLengths [required]

[integer]

List of character counts for each line in the minified file.

names [required]

[]

List of symbol names referenced in the mappings.

sourceRoot [required]

string

The root path prepended to source file paths.

sources [required]

[string]

List of original source file paths.

sourcesContent [required]

[string]

List of original source file contents corresponding to the paths in sources.

version [required]

int64

The version of the source map format (typically 3).

id [required]

string

The unique identifier of the source map file, typically the path to the file.

type [required]

enum

The resource type for source map file objects. Allowed enum values: sourcemap_files

{
  "data": {
    "attributes": {
      "file": "bundle.js",
      "mappings": "AAAA,OAAO,CAAC,GAAG",
      "minifiedLineLengths": [
        50,
        30
      ],
      "names": [
        "console",
        "log"
      ],
      "sourceRoot": "/",
      "sources": [
        "src/index.js",
        "src/utils.js"
      ],
      "sourcesContent": [
        "console.log('index');",
        "export function util() {}"
      ],
      "version": 3
    },
    "id": "path/to/sourcemap.js.map",
    "type": "sourcemap_files"
  }
}

Bad Request

API error response.

Expand All

Field

Type

Description

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Not Found

API error response.

Expand All

Field

Type

Description

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Internal Server Error

API error response.

Expand All

Field

Type

Description

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Code Example

                  # Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/sourcemaps" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}"