Skip to content

docs: add FAQ for downloading crash attachments in bulk - #329

Open
bobbyg603 wants to merge 2 commits into
masterfrom
claude/issue-328-20260805-1025
Open

docs: add FAQ for downloading crash attachments in bulk#329
bobbyg603 wants to merge 2 commits into
masterfrom
claude/issue-328-20260805-1025

Conversation

@bobbyg603

@bobbyg603 bobbyg603 commented Aug 5, 2026

Copy link
Copy Markdown
Member

Closes #328

Adds education/faq/how-do-i-download-crash-attachments-in-bulk.md, covering the three ways to get crash files and attachments out of BugSplat:

  • From the app — the Download column is hidden by default on the Crashes page and the Crash Group page; the page walks through enabling it via Column Visibility and points at Searching/Grouping/Timeframe for narrowing the table first. Includes the annotated screenshot from the issue as .gitbook/assets/download-crash-attachments-column.png.
  • With the API — list crashes with the Crashes endpoint, then fetch each crash's pre-signed dumpfile zip (crash file + all attachments) from Crash. A danger callout caps this at one request per second, and the limit is repeated inline in the download steps. A second hint notes API access requires an OAuth2 token with the restricted scope and a Business or Enterprise plan.
  • With a webhook — for anyone who wants a copy of every crash BugSplat receives, a "Get every crash with a webhook" section points at the Webhook integration instead of polling, and warns that it fires once per crash with no retries, so the endpoint has to handle peak crash volume (ack fast, download crashFileUrl from a background queue).

Also cross-links the single-file Attachments tab flow in Using the App, and adds the SUMMARY entry after the IP addresses FAQ.

Verification

The repo has no build, lint, or test tooling (GitBook-synced markdown, no package.json/CI), so verification was a link audit:

  • Every relative link and image reference in the new page resolves on disk; both cross-page heading anchors (using-the-app.md#previewing-attached-files, crash.md#get-crash) and the same-page #get-every-crash-with-a-webhook anchor exist; all {% hint %} blocks are balanced.
  • Every SUMMARY.md entry still resolves, and every .md file in the repo is still listed in SUMMARY.md.

Rendering was not checked in GitBook itself.

🤖 Generated with Claude Code

bobbyg603 and others added 2 commits August 5, 2026 10:29
Documents both paths users ask about: the Download column in the app
(hidden by default on the Crashes and Crash Group pages, enabled via
Column Visibility) and scripting the Crashes + Crash endpoints to pull
the pre-signed dumpfile zip that holds the crash file and attachments.
Notes that API access needs an OAuth2 token with the restricted scope
and a Business or Enterprise plan. Adds the annotated screenshot and
the SUMMARY entry.

Closes #328.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…webhook

Adds a danger callout capping Crash API polling at one request per second,
repeats the limit inline in the download steps, and adds a "Get every crash
with a webhook" section for anyone who needs more throughput than that. Warns
that the webhook fires once per crash with no retries, so the endpoint has to
keep up with peak crash volume.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

FAQ for Download Crash Attachments in Bulk

1 participant