HTMX hx-delete/hx-post to Flask with CSRFProtect returns 400 'The CSRF token is missing.': send the token as an X-CSRFToken header via hx-headers
Fix: put the token in a header once, on a parent element, and every HTMX request below it inherits it:
<body hx-headers='{"X-CSRFToken": "{{ csrf_token() }}"}'>Flask-WTF's CSRFProtect reads X-CSRFToken (and X-CSRF-Token) by default (WTF_CSRF_HEADERS), so the token doesn't have to be in the request body.
Cause: CSRFProtect checks every POST/PUT/PATCH/DELETE. An hx-delete button isn't inside a form with {{ form.hidden_tag() }}, so the request carries no token. Checked with Flask 3.0 + Flask-WTF 1.2.1 and the test client: DELETE /p/1 with no token returned 400 with <p>The CSRF token is missing.</p>; the same request with headers={"X-CSRFToken": token} (token rendered from {{ csrf_token() }}) returned 200. The token is tied to the session, so the client has to keep the session cookie, which browsers do.
A per-element hx-headers on each button works too, but setting it on <body> (or using an htmx:configRequest listener that sets event.detail.headers['X-CSRFToken']) means you don't forget it on new partials. Requests go to your own origin, so the token never leaves it.