Visual RFC.
ALL RFCs / RFC 5789
Read the RFC ↗
RFC 5789 / MECHANISM GUIDE

Discover patch formats

04

Accept-Patch lists the patch media types accepted for the target resource.

Related RFCs and changes

“Updates” changes part of an earlier RFC. “Obsoletes” replaces it. This list shows selected related documents.

DIAGRAM§ 3.1 ↗
RFC 5789 · § 3.1EXAMPLE
3 / 3
Discover patch formatsAccept-Patch lists the patch media types accepted for the target resource.Discover patch formatsClientServerOPTIONS /itemAllow: GET, PATCHAccept-Patch: application/json-patch+jsonChoose a supported format, not arbitrary JSON
03
Read Accept-Patch

Select a supported document format rather than assuming arbitrary JSON works.

Protocol participantThreat or exceptionProtocol controlSimplified drawings · precise section references
KEY POINT

Accept-Patch should appear in OPTIONS responses for PATCH-capable resources.

  • Accept-Patch should appear in OPTIONS responses for PATCH-capable resources.
  • Its presence implicitly indicates PATCH is allowed on that target.
  • Allow advertises methods; Accept-Patch advertises formats.
DETAILS

Examples are illustrative. Consult the linked RFC and its errata for implementation details.

Read the RFC section ↗

Diagrams simplify the RFC. Read the linked sections for complete requirements.

Privacy
All chapters in this RFC
  1. Patch versus replacement
  2. Atomic modification
  3. Conditional PATCH
  4. Discover patch formats
  5. Failure and verification
RFC 9700 / CHAPTERS

Chapters

For full details, tables, algorithms, and exceptions, read the original RFC.

RFC status and corrections ↗