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.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 by its filename, service name, and version. This endpoint requires the rum_apps_read permission.

Arguments

Query Strings

Name

Type

Description

filename [required]

string

The path to the source map file.

service [required]

string

The service name associated with the source map.

version [required]

string

The version of the service associated with the source map.

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

                  # Required query arguments
export filename="js/bundle.min.js.map"
export service="my-web-service"
export version="1.0.0"
# 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.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/sourcemaps?filename=${filename}&service=${service}&version=${version}" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}"