From 6447b2501430bf927da38177f70ab92f029ba8d4 Mon Sep 17 00:00:00 2001 From: LaurentHuzard Date: Fri, 19 Sep 2025 13:56:06 +0200 Subject: [PATCH] docs(state): advertising Linked Data Platform headers (Allow & Accept-Post) --- core/content-negotiation.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/core/content-negotiation.md b/core/content-negotiation.md index d7f1edb5ae9..dd5c9b3a8fd 100644 --- a/core/content-negotiation.md +++ b/core/content-negotiation.md @@ -409,3 +409,12 @@ use ApiPlatform\Laravel\Eloquent\Filter\JsonApi\SortFilter; )] class Book extends Model {} ``` + +### Advertising Linked Data Platform HTTP Headers (Allow & Accept-Post) + +API Platform automatically adds two HTTP headers to responses for resources: + +- **Allow** advertises enabled HTTP methods on the *current URI template*. +- **Accept-Post** advertises POST-able media types (from operation input formats) and is only present when a POST operation exists for the template. + +> See [LDP ยง4.2 / Primer notes on Accept-Post](https://www.w3.org/TR/ldp/#Accept-Post) and typical exposure via OPTIONS.