Skip to content
bucker

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.

Route groups
GroupOperationsWhat it covers
.well-known5
access-explain1
access-requests7
account-types8
accountability4
accounts2
admin98The deployment-operator console.
agent83
agent-analytics2
agent-surfaces4
agents37Autonomous agents: delegation, budgets and the trust ladder.
ai17
alert-events5
alert-rules24
analytics45
analytics-setting2
anomaly3
api39
approval-batches4
approval-policies4
approval-requests9
approvals4
approver-sets2
approver-window3
artifacts4
ask1
attachment-settings2
attachments1
auth28Authentication, sessions, MFA and account recovery.
autofix6
automation-policy2
autonomy3
autonomy-policy2
batch2
behavioral-fingerprint3
billing24Plans, usage and subscription billing.
break-glass1
budgets1
canaries1
capture2
capture-bands2
capture-rules4
capture-windows3
change-events2
change-population2
change-suspects3
change-watches2
check-batches1
check-budget4
check-policy2
check-variables8
ci22
code-mappings3
codebase3
coding-agents18
compliance30Data-subject rights, retention, residency and audit export.
config5
connections6
consent3
cost3
credential-policy3
credentials3
custom-roles4
dashboards28
data-access1
data-access-defaults2
data-quality2
data-scopes4
databases24
datasets1
decide2
dependency-commons5
deploys2
destinations12
detectors5
digest2
discarded-fingerprints2
dpa2
drains7
durability6
e2
egress-hosts3
egress-map1
environments1
escrow5
essence1
essence-by-url1
event-highlights2
evidence1
evidence-pack1
evidence-pricing6
experiments13
explore10
exports9
exposure-report3
facts4
feedback3
finding-suppressions5
findings7
firehose1
flag-cohorts2
flag-events1
flag-ramps5
flags29
freeze-windows7
gates14
governance-presets4
grouping7
grouping-precision1
grouping-suggestions5
honeytokens2
hotfix-providers1
hotfixes5
hygiene3
i4
identity18
inbound-filters3
incident-close1
incident-links1
infra22
ingest1
ingest-doors3
ingest-origin6
ingestion-filters4
insights9
install1
instrumentation3
instrumentation-patches4
integrations13
interactions5
investigation-replay-set1
investigations7
invites4
issue-embeddings1
issue-sharing2
issue-sources3
issues84Error groups: triage, timeline and remediation.
joins5
keys5
landing15
levers1
lineage1
llm-credential3
log-floor-exemptions3
log-pipeline3
log-purges5
logs8
lookup1
maintenance-windows4
mcp-client-policy1
me19The signed-in principal's own tokens, devices and digest preferences.
members4
merges2
meta3Liveness, readiness, metrics and edition metadata.
metric-series2
metrics4
mitigation-actions1
mitigation-documents1
mitigation-providers1
mitigations6
model-providers3
monitors6
neutral-verification4
notebooks8
notification-channels4
oauth10
oauth-clients3
onboarding5
operation-window-caps2
operations10
org-exports6
org-tokens3
orgs5Organization creation, membership and settings.
overlay8
oversight-packs2
owner-questions5
ownership4
performance-settings2
pipeline4
playbook-runs2
playbooks8
pricing.json1
privacy-mode5
private-locations6
probe-run2
probes2
product-events1
projects14Project creation and settings.
prometheus2
proof-ledger19An organization's tamper-evident proof ledger.
proposals5
public10Unauthenticated routes served to end users and integrations.
query-runs2
query-tokens3
quota2
receipts1
release-attestations3
release-compare1
release-expectations1
release-health2
release-settings2
release-verdict-policy1
release-verdicts2
releases5
replay14
replays3
repos6
resources4
retention7
revenue6
reversal-debt5
review-mode6
rollout-overview2
rollouts9Feature-flag rollout evaluation and bisection.
rollups2
routing-policies5
s2
sampling-rules5
saved-queries10
scim23SCIM provisioning for users, groups and agents.
scm1Source-control provider connections.
scoreboard14Autonomy scoreboard attempts, replays and pins.
scorecards5
sdks3
security1
security-imports4
security-lane1
security-policy2
services8
setup-cells1
share1
skills7
slos2
sources8
sso6SAML and OIDC single sign-on connections.
stack-receipt2
state-probes6
stats1
status19Public status-page summaries.
status-pages53Status pages an organization manages: pages, components, bindings, incidents, maintenance, subscribers, the custom domain, brand assets and the setup read.
subject-requests7
subjects1
suite-config3
support-access3
surface1
survey-bundle1
survey-overview1
survey-respondent-keys3
surveys38
task-grants6
taxonomy4
teams12
telemetry-contract4
traces3
transparency8The public transparency register and its Merkle proofs.
tripwire2
uptime-monitors13
usage-alerts3
user-notice-sender-domains4
user-notices7
v110
v1development1
views6
warehouse11
watchers3
web18
webhook-events1
webhooks20Inbound webhooks from source control, Stripe and integrations.
widget-preview1