Skip to main content
POST
Enrich a stack trace

Restrictions

Usage

  • type defaults to browser when omitted.
  • service and version must match the values used at upload time; frames with no matching symbols come back with converted: false.
  • Set near from 1 to 20 to include source-code snippets around converted frames.
  • source_type (the error’s error.source_type) can reroute the request: with type: android, a value containing ndk — or an empty value plus arch — uses NDK native symbols; with type: flutter or react-native, ios uses dSYM and android/ndk uses Android symbols; with type: electron, macos/windows/linux uses Breakpad symbols for minidump frames.
  • For iOS crash stacks, pass binary_images so addresses can be relocated against the uploaded dSYM files.
  • Results are cached per stack; no_cache: true bypasses the cache and is intended for debugging.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Stack trace enrichment request.

service
string
required

Application or service name used when the sourcemap was uploaded.

version
string
required

Application version used when the sourcemap was uploaded.

arch
string

Native CPU architecture, such as arm, arm64, x86 or x64. With type: android and an empty source_type, sending arch selects NDK native symbolication.

binary_images
object[]

Loaded binary images from an iOS crash report.

build_id
string

Android build ID for Gradle plugin 1.13.0 and later.

near
integer

Number of nearby meaningful source lines to return around converted frames.

Required range: 1 <= x <= 20
no_cache
boolean

Skip cached enrich results. Intended for debugging.

platform
enum<string>

Narrows a react-native enrich to the app's native platform: ios for the iOS native layer, android for the Android native layer (the console derives it from the event's OS). Ignored for other type values.

Available options:
ios,
android
source_type
string

The error's error.source_type as reported by the SDK. It reroutes symbolication: for android, a value containing ndk selects NDK native symbols; for flutter and react-native, ios selects dSYM and android/ndk selects Android symbols; for electron, macos, windows or linux selects Breakpad symbols. Ignored for other types.

stack
string

Raw stack trace to parse and enrich.

type
enum<string>

Source platform whose symbol store is used. Defaults to browser when omitted.

Available options:
browser,
android,
ios,
miniprogram,
harmony,
flutter,
electron,
react-native
variant
string

Android build variant used by older Gradle plugin versions.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Enriched stack frames.