Get a JavaScript source map
https://api.datadoghq.com/api/v2/sourcemapshttps://api.us3.datadoghq.com/api/v2/sourcemapshttps://api.us5.datadoghq.com/api/v2/sourcemapshttps://api.datadoghq.eu/api/v2/sourcemapshttps://api.ap1.datadoghq.com/api/v2/sourcemapshttps://api.ap2.datadoghq.com/api/v2/sourcemapshttps://api.uk1.datadoghq.com/api/v2/sourcemapshttps://api.ddog-gov.com/api/v2/sourcemapshttps://api.us2.ddog-gov.com/api/v2/sourcemapsOverview
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"
Arguments
Query Strings
debug_idThe debug ID of the JavaScript source map, in UUID format. When provided, filename, service, and version are not required and are ignored.
filenameThe path to the source map file. Required when debug_id is omitted.
serviceThe service name associated with the source map. Required when debug_id is omitted.
versionThe version of the service associated with the source map. Required when debug_id is omitted.
Response
OK
Response containing a JavaScript source map file.
data [required]JavaScript source map file data object.
attributes [required]Attributes of a JavaScript source map file.
file [required]The name of the minified JavaScript file.
mappings [required]The Base64 VLQ encoded string that maps positions in the minified file to positions in the original source files.
minifiedLineLengths [required]List of character counts for each line in the minified file.
names [required]List of symbol names referenced in the mappings.
sourceRoot [required]The root path prepended to source file paths.
sources [required]List of original source file paths.
sourcesContent [required]List of original source file contents corresponding to the paths in sources.
version [required]The version of the source map format (typically 3).
id [required]The unique identifier of the source map file, typically the path to the file.
type [required]The resource type for source map file objects.
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.
errors [required]A list of errors.
detailA human-readable explanation specific to this occurrence of the error.
metaNon-standard meta-information about the error
sourceReferences to the source of the error.
headerA string indicating the name of a single request header which caused the error.
parameterA string indicating which URI query parameter caused the error.
pointerA JSON pointer to the value in the request document that caused the error.
statusStatus code of the response.
titleShort 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.
errors [required]A list of errors.
detailA human-readable explanation specific to this occurrence of the error.
metaNon-standard meta-information about the error
sourceReferences to the source of the error.
headerA string indicating the name of a single request header which caused the error.
parameterA string indicating which URI query parameter caused the error.
pointerA JSON pointer to the value in the request document that caused the error.
statusStatus code of the response.
titleShort 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.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Internal Server Error
API error response.
errors [required]A list of errors.
detailA human-readable explanation specific to this occurrence of the error.
metaNon-standard meta-information about the error
sourceReferences to the source of the error.
headerA string indicating the name of a single request header which caused the error.
parameterA string indicating which URI query parameter caused the error.
pointerA JSON pointer to the value in the request document that caused the error.
statusStatus code of the response.
titleShort 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
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/sourcemaps" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"