# Mettre à jour un document juridique

`PATCH /v1/legal-documents/{id}` · permission `legal-documents:write`

Modifie uniquement `requires_reacceptance` et, tant que le document n'est pas en vigueur, `effective_at` (JSON Merge Patch, RFC 7396). Les autres champs ne font pas partie du schéma (`400 unknown_field`) et aucun des deux champs ne peut être `null`. Un correctif sans changement n'écrit rien et renvoie le document inchangé. Les documents n'ont pas de version : `If-Match` n'est pas utilisé.

## Requête

Paramètres de chemin :

| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| `id` | string | oui | ID du document (`ldoc_…`). |

Corps JSON merge patch (`application/merge-patch+json`) (les champs inconnus sont rejetés avec `400 unknown_field`) :

| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| `requires_reacceptance` | boolean | non | Nouvelle valeur ; ne peut pas être `null`. |
| `effective_at` | string (date-time) | non | Uniquement tant que le document n'est pas en vigueur ; ne peut pas être dans le passé. |

## Réponse

`200 OK` avec le document.

```json
{
  "id": "ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "application_id": null,
  "kind": "terms",
  "version": "2026-10",
  "locale": "en",
  "url": "https://example.com/legal/terms-2026-10",
  "content_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "effective_at": "2026-11-01T00:00:00Z",
  "requires_reacceptance": true,
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 400 | `unknown_field` | Le correctif contient un champ autre que `requires_reacceptance` et `effective_at`, ou n'est pas un objet JSON (`malformed_request`). |
| 404 | `not_found` | Le document n'existe pas ou appartient à un autre environnement. |
| 415 | `unsupported_media_type` | Le type de contenu n'est pas `application/merge-patch+json`. |
| 422 | `validation_failed` | Un champ est `null` (`invalid`), `effective_at` est mal formé ou dans le passé, ou le document est déjà en vigueur (`immutable`). |
| 401 | `unauthenticated` | L'authentification est manquante, invalide ou révoquée. |
| 403 | `insufficient_permissions` | L'authentification manque la permission requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la période `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la période `Retry-After`. |

## Exemple

```bash
curl -X PATCH https://api.eu.keenauth.com/v1/legal-documents/ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{"requires_reacceptance":true}'
```