Fictura
Errors & traces

Upload source maps & symbols

The uploads that turn minified and native stacks back into readable ones, usually made from CI.

npx fictura-sdk upload-sourcemaps, upload-dsym and upload-mapping call these for you: see Source maps and Native crashes. This page is the contract behind them.

Authorization

Authorization: Bearer fk_data_… with the sourcemaps:upload scope. The SDK key (gk_) can never upload: it ships inside your app. Create the key in Dashboard → Setup → Keys & webhook → Data API keys.

Source map

PUT /api/v1/sourcemaps/:debugId?name=&release=&platform=

:debugId is the bundle's debug id, a UUID. name (the file name) is required; release and platform are optional. The body is the version 3 source map itself, raw JSON or gzip: up to 60 MB as sent, 150 MB uncompressed.

cURL
curl -X PUT "https://api.fictura.co/api/v1/sourcemaps/85314830-023f-4cf1-a267-535f4e37bb17?name=main.jsbundle.map&release=2.0.68" \
  -H "Authorization: Bearer fk_data_..." \
  -H "Content-Type: application/gzip" \
  --data-binary @main.jsbundle.map.gz

The 200 is {"ok": true, "source_map": {…}, "replaced": false, "requeued": 12}: replaced says it overwrote different bytes for the same debug id and name, and requeued counts that build's events from the last 7 days put back in line to resolve. A map unused for 90 days is deleted.

StatuserrorWhy
400invalid_debug_id / missing_name / empty_bodyThe URL or body is missing what it needs.
400invalid_gzip / invalid_mapThe body can't be read as a version 3 source map.
400debug_id_mismatchThe map names a different debug id than the URL.
413too_largeOver a size cap.
503storage_unavailableThe map could not be stored. Try again.

iOS symbol table

PUT /api/v1/symbols/dsym/:uuid?name=&arch=&text_vmaddr=&release=

:uuid is the binary's UUID and name is required. The body is not the dSYM: it is a text symbol table, one per binary and architecture, which upload-dsym builds from the dSYM on your machine. Use the CLI.

Android mapping

PUT /api/v1/symbols/proguard?app_id=&version_code=&release=

app_id (the applicationId) and version_code are required. The body is the R8 or ProGuard mapping.txt.

Both symbol uploads

Bodies may be gzip: up to 80 MB as sent, 200 MB uncompressed. The 200 is {"ok": true, "symbols": {…}, "replaced": false, "reresolved": 12}, where reresolved counts the app's events from the last 7 days resolved again with the new symbols, at most 500. A file unused for 90 days is deleted.

StatuserrorWhy
400invalid_uuid / missing_name / invalid_text_vmaddr / invalid_build / empty_bodyThe URL or body is missing what it needs.
400invalid_gzip / invalid_symbols / invalid_mappingThe body can't be read.
400uuid_mismatchThe file names a different UUID than the URL.
413too_largeOver a size cap.
503storage_unavailableThe file could not be stored. Try again.

On this page