API reference
AI-first error monitoring — control-plane API. 1846 operations across 1546 paths, version 0.1.0. Every page below is generated from https://api.bucker.io/openapi.json — the same document the API serves, so a route that changed shape here changed shape there.
Base URL and authentication
The control plane is https://api.bucker.io. Requests carry a bearer token: a personal access token (bkr_pat_) for a script, or a session token for the dashboard. Tokens are org-pinned and their scopes are re-intersected with live memberships on every request, so a demoted owner’s token shrinks without anything being revoked.
For CI, prefer an org token (bkr_org_), minted by an owner or admin under Settings → Tokens. It belongs to the organization rather than to a person, so it keeps working when whoever minted it leaves, and it can only ever create releases, record deploys, upload artifacts (release:write) and read projects (project:read). Everything it does is attributed to its own principal in the audit log, and any owner or admin can revoke it.
curl https://api.bucker.io/orgs/{orgSlug}/projects \
-H "authorization: Bearer $BUCKER_TOKEN"The data plane is a different host and a different credential: envelopes go to the region-prefixed ingest host in your DSN, authenticated by the DSN’s public key alone. That protocol has its own page — see the ingest wire protocol.
Errors, pagination and versioning
Error responses are listed per route below. The rule behind them: every endpoint answers 400 for a body that fails validation, 401 without a usable token, 403 when the token is valid but the scope or membership is not, 404 for a resource this principal cannot see, and 429 with x-ratelimit-* headers. List endpoints are keyset-paginated: pass the nextCursor from the previous page back as cursor. Every response carries X-API-Version, and a route on its way out carries RFC 8594 Deprecation, Sunset and a successor Link.
Route groups
Grouped by the tag the API assigns each route. The full document is 23.2 MB, which is why it is linked rather than inlined: a reference you have to download is not a reference.