Raw API alternative: POST /api/0/organizations/{org}/releases/{version}/files/ as multipart/form-data with fields file (the artifact), name (the exact URL the browser loads, e.g. https://example.com/app.js.map), optional dist — docs: https://docs.sentry.io/api/releases/upload-a-new-organization-release-file/
Token scopes: org:ci, project:releases, project:write, or project:admin.
Verify: trigger a test error and confirm frames resolve to original source in the Sentry UI.
Known gotchas
name must match the URL in stack traces EXACTLY — protocol, domain, path, case. A mismatch silently breaks symbolication.
If you build multiple variants, set dist consistently on both the SDK event and the uploaded artifact or maps won't apply.
Prefer sentry-cli over raw uploads: it batches, validates, and rewrites sourceMappingURL references for you.
EU/region orgs use their region domain (e.g. de.sentry.io) as API base for uploads.
Verified against https://docs.sentry.io/api/releases/upload-a-new-organization-release-file/ and https://docs.sentry.io/product/cli/releases/ on 2026-08-04.
Give your agent this knowledge — and 16,400+ more routes
One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?