API reference

AI-first error monitoring — control-plane API. 652 operations across 523 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 (bpat_) 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.

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 6.3 MB, which is why it is linked rather than inlined: a reference you have to download is not a reference.