Skip to content

docs: Add ADR 0044 - API standards for updating and deleting resources - #885

Draft
mike-gorman-bitwarden wants to merge 1 commit into
mainfrom
docs/adr-0044-api-standards-for-updating-and-deleting-resources
Draft

mike-gorman-bitwarden wants to merge 1 commit into
mainfrom
docs/adr-0044-api-standards-for-updating-and-deleting-resources

Conversation

@mike-gorman-bitwarden

@mike-gorman-bitwarden mike-gorman-bitwarden commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

🎟️ Tracking

Follow-up to ADR-0036 (#865).

📔 Objective

Adds ADR-0044, "API standards for updating and deleting resources", with status Proposed. Sets how resources are updated and deleted: PUT with complete replacement, partial updates (discouraged; RFC 7396 semantics with a recorded departure on empty strings), optimistic concurrency with a version field and 409 (with the recorded departure from conditional requests), and hard and soft deletes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying contributing-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4308a99
Status: ✅  Deploy successful!
Preview URL: https://4fdfaf1d.contributing-docs.pages.dev
Branch Preview URL: https://docs-adr-0044-api-standards.contributing-docs.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant