---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Source maps"
description: "The `source_maps` collection of Sylphx Observability: A Source Map is one uploaded JavaScript source map of one release of a project environment."
type: reference
product: monitoring
summary: "A Source Map is one uploaded JavaScript source map of one release of a project environment."
updated: 2026-09-28
order: 900
---

A Source Map is one uploaded JavaScript source map of one release of a project environment. Captured stack frames of that release whose file matches `file_url` are mapped back to the original source before grouping. Uploading the same release and file again replaces the map.

**Service** Sylphx Observability · **Resource type** `observability.sylphx.com/SourceMap` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/source_maps/{source_map}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/source_maps/{source_map}`. |
| `uid` | `string` | `smp_<digest>`; the same release and file always have the same id. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `release` | `string` | The release the map belongs to, as sent in `ErrorEvent.release`. Required. |
| `file_url` | `string` | The minified file the map describes: its URL (`https://app.example.com/assets/index-3f2a.js`) or its path (`/assets/index-3f2a.js`). A frame matches on the URL path. Required. |
| `content` | `string` | The source map JSON (revision 3), at most 16 MiB. Written, never read back. Required. |
| `content_sha256` | `string` | SHA-256 of `content`, hex. Output only. |
| `size_bytes` | `int64` | Size of `content` in bytes. Output only. |
| `upload_time` | `timestamp` | When the map was uploaded. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `POST` | [`create`](/docs/api/source_maps#create) | Uploads a source map for one release and minified file. Uploading the same release and file again replaces it. |
| `GET` | [`get`](/docs/api/source_maps#get) | Gets a source map (without its content). |
| `GET` | [`list`](/docs/api/source_maps#list) | Lists source maps, newest first; filter by `release`. |

## create

Uploads a source map for one release and minified file. Uploading the same release and file again replaces it.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/source_maps` · scope `observability:write` · effect `write` · [Request, response and examples](/docs/api/source_maps/create)

## get

Gets a source map (without its content).

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/source_maps/source-map` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/source_maps/get)

## list

Lists source maps, newest first; filter by `release`.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/source_maps` · scope `observability:read` · effect `read` · paginated · [Request, response and examples](/docs/api/source_maps/list)