API changelog
One line for every change to the public REST API document (openapi.json): what was added,
changed or removed, written for the person calling the API. A test
(sdks/api-client/test/drift.test.ts) fails when the committed document has no line here, so
an API change cannot ship without somebody saying what it was.
Add a line with:
pnpm --filter @bucker/api-client changelog:stamp "<what changed>"
The spec: value is a fingerprint of the document (its canonical JSON, so formatting and key
order do not count). Only the line for the current document has to exist; older lines are
history.
- 2026-10-17
spec:baselineStarting point for this log. The document already described the issue, project, alerting, integration, remediation, ingest and administration routes; entries below record each change after it. - 2026-10-17
spec:861abedea510Added org webhook subscriptions (/orgs/{orgSlug}/webhooks), the Teams bot endpoint and manifest, and the webhook-events catalogue. - 2026-10-17
spec:a11110397633Added bulk merge of grouping suggestions (POST .../grouping-suggestions/merge) and a degradedBecause field on the suggestion scan result. - 2026-10-17
spec:328e515e3e55Merged the sentry-gaps line: issue workflow (grouping rules, archive conditions, review, delete/discard, inbound filters, comments, ownership), the org-wide stream and exports, alerts and personal notifications, releases and release health, Explore, logs and metrics, replay, dashboards and performance, crons and status, the CLI and config-as-code, admin and identity, the AI lane, commercial and Sentry upload routes. - 2026-10-17
spec:18f5047c2686Alert rules accept a metric-threshold condition over customer metrics (explicit aggregate, delta/rate for counters); the log search accepts the shared grammar (OR, groups, ! negation, [a,b] lists). - 2026-10-17
spec:95f9b2831dabOutbound webhooks can be edited and deleted; sessions carry their sign-in method, with a step-up route for actions that need a fresh factor; a guest session for the read-only sandbox organization. - 2026-10-17
spec:d21cf8f31d4fPlans and subscriptions carry add-on placement and entitlement (addOns.mitigate: included, paid add-on or absent; provisional pending a pricing decision); an operator route records a purchased add-on (POST /admin/tenants/{orgSlug}/add-ons); requesting or applying a mitigation or hotfix without the Mitigate add-on is a 403 naming it. - 2026-10-21
spec:28e231507467Status pages: GET .../setup (the setup state: steps, facts and what the caller may do), POST .../setup/components (monitors, components and bindings in one request), PUT/DELETE .../brand/{asset} (logo and favicon upload), POST .../domain/check (look at a hostname's DNS now; GET .../domain/verify is deprecated); the domain state carries claim expiry, last and next check, per-record status, automation and the awaiting_publish state; the new status:write scope joins every scopes enum (personal, organization and agent tokens, and delegations). - 2026-10-29
spec:16c96665120eTable R's 36 new scopes (infra, analytics, cost, security, database, governance reads; narrow writes such as flags:write, metrics:write, logs:write; human-only pii:read, egress:admin, experiments:ship) join every scopes enum (personal, organization and agent tokens, and delegations), whose bound grows from 20 to 56; a custom role may name up to 64 scopes (was 32). The MCP resource's scopes are unchanged. - 2026-11-05
spec:3fc775123ca3Added GET /orgs/{orgSlug}/projects/{projectSlug}/query-runs and /query-runs/summary: the query log (WH-04), one row per compiled read with principal, sponsor, client, surface, digests and cost - 2026-11-05
spec:4201d244b95dReview mode: GET/PUT /orgs/{orgSlug}/review-mode, GET/PUT /orgs/{orgSlug}/projects/{projectSlug}/review-mode, POST/DELETE /orgs/{orgSlug}/review-mode/production-opt-in - 2026-11-05
spec:3f74b3549afdReview mode: POST /orgs/{orgSlug}/review-mode/production-opt-in takes a fresh WebAuthn step-up assertion (webauthn) or the current password; a session's sign-in factor alone is no longer a proof; OAuth client identities (ACP-07): GET /orgs/{orgSlug}/oauth-clients, POST /orgs/{orgSlug}/oauth-clients/{identityId}/disable and /enable, PUT /orgs/{orgSlug}/mcp-client-policy; log never-drop floor (LOG-01): GET/POST /orgs/{orgSlug}/projects/{projectSlug}/log-floor-exemptions and DELETE .../log-floor-exemptions/{exemptionId} (human-only org admin, one template or filter set, at most 7 days), and GET .../sampling-rules now returns floorKeptCount on each rule and floorExemptions beside data - 2026-11-05
spec:2bb52ec89530alert rules lists gain an evaluation block per rule (state, lastEvaluatedAt, lagMs, quarantined, errorClass, quarantinedSince, nextRetryAt); POST /orgs/:org/projects/:project/alert-rules/:ruleId/retry-evaluation retries a quarantined rule; GET /admin/capacity returns the operator-only capacity gauges, the F-01 triggers T1-T5 and the pillar flag states, and POST /admin/ops-flags takes an optional reason that is required to enable a pillar flag while a dependent capacity gauge is in breach - 2026-11-05
spec:c0b0f7032170added the product-analytics gate: GET and PUT /orgs/{orgSlug}/projects/{projectSlug}/analytics-setting, GET /orgs/{orgSlug}/dpa and POST /orgs/{orgSlug}/dpa/accept (PA-01) - 2026-11-05
spec:9cc54d724e4bOperations carry x-bucker-scope, x-bucker-relation and (for a governed act) x-bucker-action extensions from the operation table; added POST /admin/scopes/{scope}/enforce-now and /enforce-now/preview: the operator action that ends a re-priced scope's preview window early - 2026-11-05
spec:eefcd73ea4aeAdded GET /orgs/{orgSlug}/projects/{projectSlug}/web/agents (the Agents view over request-line logs) and POST /api/{projectId}/http-log/ (request lines as NDJSON) - 2026-11-05
spec:5c9e614dfeb6WEB-09: the Agents view and http-log door operations carry their relation - 2026-11-05
spec:f96eb9ff6a16Agent grants: GET/POST /orgs/{orgSlug}/agents/{agentId}/grants, DELETE .../grants/{grantId} and POST .../grants/{grantId}/narrow (F-19) - 2026-11-05
spec:6247daa21ae6Phase 1 gate: the agent grant operations (GET/POST /orgs/{orgSlug}/agents/{agentId}/grants, DELETE .../grants/{grantId}, POST .../grants/{grantId}/narrow) carry x-bucker-scope, x-bucker-relation and x-bucker-action - 2026-11-05
spec:7c7aa05e0c89LLM-06 price book v2: GET/POST /orgs/{orgSlug}/ai/prices, DELETE .../ai/prices/{priceId} and GET .../ai/prices/effective (an organization's effective-dated contract rates over the global price book); every cost figure (GET .../agent/cost, .../cost/timeseries, .../breakdowns) carries priceSource, priceTableVersion, unpricedShare and a low end microUsdLow - 2026-11-05
spec:2945b7bfb0afuptime checks: phase timings, TLS and HTTP version and trigger on results, p50/p95 per phase on the rollup, check kind, spec version, origin, state, digest and revision on a monitor, httpVersion on create and update, and GET uptime-monitors/{uptimeSlug}/versions (P2-11) - 2026-11-05
spec:fa33779b1158Budgets (F-13): the budget kind enum on PUT /orgs/{orgSlug}/agents/{agentId}/budgets accepts QUERY_SCAN, EXPOSURE_UNITS, CI_MINUTES, PAGES, RUNS, FORECASTS and CUSTOMER_DB_TIME; added POST /orgs/{orgSlug}/budgets/lower (an agent or OAuth client lowers its own budget: agent_budget.lower); a refusal at a cap names reason BUDGET_REACHED and resetsAt - 2026-11-05
spec:4807d5b30bf0DX-01: GET /orgs/{orgSlug}/projects/{projectSlug}/replays takes groupBy (url, browser, release, environment, replay_type, issue, day; groups under 5 distinct users are folded into other) and hideViewed, and each row carries viewed; GET .../replays/export serves the list as CSV or JSON Lines (the same hidden-route shape as the issue and log exports); saved views gain the replays surface - 2026-11-05
spec:944c3d51d294deploys carry service, commit, CI trace, source, status, duration and rollback flag; POST deploys/:deployId/finish; suspect-deploy names its basis - 2026-11-05
spec:6d9ef9e35412PLAT-03: GET /orgs/{orgSlug}/billing/usage/weighted (weighted units, basis and receipts) and GET .../billing/usage/focus.csv (FOCUS rows, manage_billing); the usage summary carries events.units, events.unitsSource and byCategory[].units, and percentOfLimit and the projection are computed from weighted units (projection.projectedUnits); usage attribution rows carry units - 2026-11-05
spec:543409f7ef9clevel 1 of the unified platform: rollups, detectors and provider connections modules, the explore spec, decision page and step-up, budgets/lower, uptime check versions, log record, deploy finish and AI price routes - 2026-11-05
spec:4cc77d966084Level 2 of the unified platform (P2-31): kill switches and change freezes (agent-surfaces, freeze-windows and break-glass routes), the feature-flag mirror (flags list and flag detail), infrastructure entities and platform deploy webhooks, log patterns (logs/patterns), weighted usage (/usage/weighted), dashboard revisions, restore, visibility, archive and metric-series purge, replay export and the dashboard-save by widget key - 2026-11-05
spec:c8c6ad1fd6abDATA-05: GET /orgs/{orgSlug}/data-quality (the standing data-quality checks over the warehouse export streams, per sink and stream: state, value, threshold, basis, last run and linked issue) and POST /orgs/{orgSlug}/data-quality/checks (change one check: a governed write that answers 202 input_required until a person approves); PATCH /orgs/{orgSlug}/warehouse/sinks/{sinkId} accepts alertProjectId (the project that receives a sink's data-quality findings; null turns its checks off) - 2026-11-05
spec:fa03c487c348POST …/projects/{project}/sampling-rules/preview is new; sampling rules gain status, plan, expiresAt, shadow tallies, owner, approvalRequestId, previewDigest and version, and the create and update bodies gain status and expiresInDays. - 2026-11-05
spec:02867f77d2d8Level 3 of the unified platform (P2-43): GET /orgs/{orgSlug}/projects/{projectSlug}/infra/digest and GET .../infra/entities/{entityId}/detail (held read_infra; the fleet digest and one entity with blocks), GET /orgs/{orgSlug}/projects/{projectSlug}/alert-rules/{ruleId}/state, release-health change events (list and ingest), GET /orgs/{orgSlug}/egress-map, GET /orgs/{orgSlug}/traces/{traceId}, POST .../levers/{lever}/preview, the platform deploy webhook settings read, and the cost responses' basis, sampling and rollupCoverage fields (additive) - 2026-11-05
spec:78577efe8291Audit log: notable and changed filters, before/after and diff on entries, GET compliance/audit-log/entries/{entryId}, notable on the export - 2026-11-06
spec:28910022c3deENG-01: feedback reports gain kind, survey, release, replayId, traceId, joinKey, submitterType, language and typed answers; POST /api/:projectId/feedback accepts the same keys and an optional survey answer set - 2026-11-13
spec:454d3cb3eae0added GET .../replay/vitals (per-route web vitals p75 against a baseline, with an optional backtest) and GET .../replay/setup-health (why replay, vitals or heatmap data is missing) - 2026-11-13
spec:23f4ae054de9Waterfall response gains genAi (per-row model call facts and a header with request cost and model time) - 2026-11-13
spec:57e2b5d07b92Waterfall response gains genAi (per-row model call facts and a header with request cost and model time) - 2026-11-13
spec:4c3908ed0dcePhase 4 band A (P4-170): added whole-trace search (POST /orgs/{orgSlug}/projects/{projectSlug}/traces/search), the customer database connection routes (GET and POST /orgs/{orgSlug}/databases, GET .../databases/setup-script, POST .../databases/connect/{token}, POST .../databases/{id}/verify) and the CI results door with its two settings routes (POST /api/{projectId}/ci/reports, POST .../ci/ingest/enable and .../ci/ingest/disable) - 2026-11-13
spec:6333fc40e891SDK-15: GET /orgs/{orgSlug}/projects/{projectSlug}/sdks/manifest (the capture manifest per SDK, accepted version, diff by class, omission counts) and POST .../sdks/manifest/accept (human-only, org:admin) - 2026-11-13
spec:022cf9c21f79Adds GET /orgs/{orgSlug}/operations/undo-digest and POST /orgs/{orgSlug}/operations/undo-digest/{id}/open: the daily undo digest of acts applied without a human decision. - 2026-11-13
spec:3a93d857fcc2Phase 2 gate (P2-74): the shadow-rule routes, setup-cells, agent issue kinds and policy routes, and the rest of Phase 2's operations registered; the document is regenerated from the merged tree - 2026-11-14
spec:2157975a2995Analytics alert condition (PA-14): analytics condition in the alert rule body, GET alert-rules/{ruleId}/checks check history - 2026-11-14
spec:6cbbf27819c4Unified platform band B: database coverage and query store, CI runs and settings, check budget, Collector profiles, infra findings and agent dashboards routes - 2026-11-14
spec:7de1a6b38e9cGET /orgs/{orgSlug}/projects/{projectSlug}/issues/{id}/blast-radius gains a revenue section; GET .../issues accepts the revenueAtRisk and accountsAffected sorts and the revenue_at_risk and accounts_affected search terms - 2026-11-14
spec:23bf95470f68Phase 3 wiring A (P3-134): the control-plane routes of Phase 3 depth 0 to 3 are registered: approval batches, approver sets and attention, task grants, ladders and the autonomy path policy, resource grants, credentials and the GitHub secret-scan door, subject requests, investigations, change watches, data access, consent, identity health, web identity settings and the attribution registry, flag verification, environments and payloads, AI configuration and provider usage, warehouse deliveries and pipeline rules, sources and their webhook, the server relay door and origin policy, canaries, coding agents, agent analytics, instrumentation patches and the evidence and essence reads; approval requests gain batchId and queuePosition - 2026-11-14
spec:dc83f56b0fc7Phase 4 wiring D (P4-173): the SLO reads (GET .../slos and .../slos/{slo}), the external incident links (GET .../incident-links and POST /webhooks/incidents/{provider}/{orgId}), the routing policy routes (organization list, project list, create or replace, preview, delete), the release verdict reads and policy (release-verdicts, release-expectations, release-verdict-policy) and the finding suppression routes (list, one, create, preview, cancel) are registered - 2026-11-14
spec:06006a3d8ebaPhase 4 band E (P4-174): dead-letter, advisor, DORA, quarantine, gate override and gate API, check batch, onboarding and declared-service routes - 2026-11-14
spec:f52932957850Log facet routes and log purge routes are mounted on the telemetry plugin (Phase 4 band F) - 2026-11-14
spec:9606824477b0Phase 4 band G: database session cancel and index proposal routes, release attestations, log pattern mutes - 2026-11-14
spec:f0076a75c451Wiring A (P5-195): facts and owner questions, playbooks and their runs, scorecards, organization skills, the approval narrowing pair and the config lag and schema routes - 2026-11-14
spec:7465715457deSurvey results and the response archive routes, the survey_answers Explore dataset and the survey_answer_received alert condition (P3-185) - 2026-11-14
spec:60509b84991aadded the continuous profile ingest doors, the Datadog Agent and Firehose log doors, the sealed transcript key routes, the scanner result import routes and the operator SDK canary read - 2026-11-14
spec:d2d33ec35f4aWiring B (P5-196): the four ingest doors name their reason in the document, the wire doors' descriptions come from the allowlist - 2026-11-14
spec:c5625a033548Phase 5 wiring C (P5-197): the PostHog- and Segment-shaped ingest doors and their door switches, the browser security report endpoint, the live-page overlay, capture windows, affected-user notices and their unsubscribe pair, and the insight analyses route - 2026-11-14
spec:993d039ee5ebPublic insight and web share link descriptions open with the shared public-route sentence - 2026-11-14
spec:7cb1069d100aPhase 5 wiring D (P5-198): watchers, the earned-autonomy rung, investigation labels, the oversight pack and change population, access requests, hygiene, privacy modes, prompt rollouts, coding-agent hooks and experiment design routes are mounted - 2026-11-14
spec:9e23e5e20c95Phase 5 wiring E (P5-199): notebooks (list, one, revisions, one revision, validate, drafts, changes and the human-only delete under /orgs/{orgSlug}/projects/{projectSlug}/notebooks) - 2026-11-14
spec:12e41fee2311Wiring F (P5-200): the Prometheus query door, the dashboard interchange and report routes, the infra lever bands and OpAMP doors, the private-location routes, the alert acknowledgement, the CI test splits and the hand-off issue-source routes join the document. - 2026-11-15
spec:216809ff389cadded the insight parity receipt endpoint (POST /orgs/{orgSlug}/projects/{projectSlug}/landing/parity/insights) and GET /public/autonomy-scale - 2026-11-15
spec:735b494f3a1dthe insight parity receipt endpoint (POST /orgs/{orgSlug}/projects/{projectSlug}/landing/parity/insights) declares org:admin, the stricter of the two checks it makes, instead of project:write - 2026-11-15
spec:67618387813bPhase 5 wiring I (P5-203): the usage statements (list, one, evidence line, hourly rows and offline verification under /orgs/{orgSlug}/billing/statements) - 2026-11-15
spec:fdf90557025aPhase 5 (unified platform): playbooks and runs, experiments and decisions, approver narrowing, earned autonomy offers, profiles, comparisons, forecasts, report schedules, config-as-code lag, importers, tracking plans, security reports, health-data mode; the regenerated document is 1545 paths, and every new operation declares its relation and scope - 2026-11-18
spec:48d0285e91a8Dashboard doors (2026-11-16): GET .../log-quotas and .../log-drains; POST .../log-purges/{jobId}/schedule/challenge, and .../schedule now takes an optional stepUp (enforced in production); GET .../metrics/tag-rules, .../derived-metrics and .../derived-metrics/{name}/dependents, POST .../derived-metrics/{name}/versions/{v}/certify and its /challenge; GET .../block-rules, POST .../block-rules/{ruleId}/enable and its /challenge; GET /orgs/{orgSlug}/security-sweep, POST .../security-sweep/drafts/{draftId}/apply and /dismissals, each with a /challenge; GET .../attack-summary; POST /orgs/{orgSlug}/cost/caps/{capId}/lift and cost/units/{key}/certify, each with a /challenge; POST /orgs/{orgSlug}/cost/allocation-rules/preview. Every write is a person's act with a single-use step-up. Behaviour change: POST /webhooks/sources/{sourceId} now accepts only x-bucker-signature t=,v1= (HMAC-SHA256 of t.body, five minute window); the earlier sha256= form is refused with the same 401. OAuth consent responses (/oauth/requests/{handle}, /oauth/device/lookup): a toolset state is now live, available or not_granted (was live, locked or not_granted), lockedReason is gone and each toolset carries cost (tools, tokens).