Skip to content

versions.md

Latest commit

 

History

History
150 lines (117 loc) · 8.38 KB

versions.md

File metadata and controls

150 lines (117 loc) · 8.38 KB
description API Documentation for the BugSplat Versions Endpoint

Versions

{% hint style="info" %} This endpoint supports paging and filtering queries. For more information on paging, filtering, and grouping, please visit this link. {% endhint %}

Get a list of stats for crashes separated by application and version, create a new version, or set the retired and full dumps flags on a specified version.

Get Versions

GET https://app.bugsplat.com/api/v2/versions

Returns a list of versions in a given database.

Query Parameters

Name Type Description
database string BugSplat database containing symbol stores

{% tabs %} {% tab title="200 " %}

{
  "database": "Fred",
  "pageData": [],
  "rows": [
    {
      "symbolId": "489912",
      "appName": "MyConsoleCrasher",
      "version": "7.0.1",
      "size": "46.1987",
      "lastUpdate": "2025-11-01T00:31:20Z",
      "lastReport": "2025-10-31T00:24:07Z",
      "firstReport": "2025-10-31T00:24:07Z",
      "reportsPerDay": null,
      "fullDumps": "0",
      "rejectedCount": "0",
      "retired": "0"
    }
  ]
}

{% endtab %} {% endtabs %}

Curl Example

curl --location 'https://app.bugsplat.com/api/versions?database=fred' \
--header 'Authorization: Bearer ••••••'

Create Versions

POST https://app.bugsplat.com/api/v2/versions

Used to create a new version and returns a pre-signed URL that can be used to upload new symbol files.

Request Body

Name Type Description
database string BugSplat database in which the symbol store should be created
appVersion* string Version of the application symbols being stored in the new symbol store
appName* string Name of application symbols being stored in the new symbol store
symFileName string Filename of the symbol file being uploaded to the symbol store via the returned pre-signed URL.
size number Size of symbol file being uploaded to the symbol store via the returned pre-signed URL. Enter 0 to create a placeholder symbol store

{% tabs %} {% tab title="200 " %}

{
    "Status": "Success",
    "url": "",
    "database": "Fred",
    "appName": "test",
    "appVersion": "1.0"
}

{% endtab %} {% endtabs %}

Curl Example

curl --location 'https://app.bugsplat.com/api/versions' \
--header 'Authorization: Bearer ••••••' \
--form 'database="fred"' \
--form 'appName="Postman"' \
--form 'appVersion="1.2.3"' \
--form 'size="0"' \
--form 'symFileName="test.pdb"'

Update Versions

PUT https://app.bugsplat.com/api/v2/versions

Used to set the retired and fullDumps flags for a specified version.

Request Body

Name Type Description
database string BugSplat database in which the symbol store should be created
appVersion* string Version of application for which the retired/fullDumps flags should be updated
appName* string Name of application for which the retired/fullDumps flags should be updated
fullDumps 0|1

Flag indicating that the BugSplat Native and .NET SDKs should generate and upload

full memory dumps

. This feature incurs additional costs.

Contact us

to enable full memory dumps for your account.
retired 0|1 Flag indicating that the version should be marked as retired. Crash reports for retired versions will not be ingested or processed.

{% tabs %} {% tab title="200 " %}

{
    "Status": "Success",
    "database": "Fred",
    "symbolId": 163434,
    "retired": 1
}

{% endtab %} {% endtabs %}

Delete Versions

DELETE https://app.bugsplat.com/api/v2/versions

Remove symbols from a specified version or versions.

Path Parameters

Name Type Description
database* string BugSplat database containing versions with symbols for removal
appName string Single application name to remove symbols for, required if appVersion is set
appVersion string Single application version to remove symbols for, required if appName is set
appVersions array Multi-dimensional array of appName and appVersion for symbol removal eg app0,version0,app1,version1. Required if appName and appVersion are not set.

Curl Example

curl --location --request DELETE 'https://app.bugsplat.com/api/versions?database=fred&appName=Postman&appVersion=1.2.3' \
--header 'Authorization: Bearer ••••••'