> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethaki.space/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/forget

> Oublier un fait ou un sujet — deux modes, un reçu horodaté

Voir [Forget (oubli)](/fr/concepts/forget) pour le fonctionnement complet.

<ParamField body="project_id" type="string" required>1 à 128 caractères.</ParamField>

<ParamField body="subject_id" type="string">
  **Exactement un** de `fact_id` / `subject_id` requis.
</ParamField>

<ParamField body="fact_id" type="uuid" />

<ParamField body="mode" type="string" required>
  `"disable"` (réversible) ou `"delete"` (effacement réel). Pattern
  regex `^(disable|delete)$`.
</ParamField>

### Réponse — `200 OK`

<ResponseField name="status" type="string" default="ok" />

<ResponseField name="mode" type="string" required />

<ResponseField name="scope" type="string" required>`"fact"` ou `"subject"`.</ResponseField>
<ResponseField name="forget_id" type="uuid" required>L'identifiant du reçu, dans `forget_receipts`.</ResponseField>

<ResponseField name="facts_disabled" type="integer" default="0" />

<ResponseField name="facts_deleted" type="integer" default="0" />

<ResponseField name="conflict_sets_deleted" type="integer" default="0" />

<ResponseField name="events_deleted" type="integer" default="0" />

<ResponseField name="traces_deleted" type="integer" default="0" />

<RequestExample>
  ```bash curl theme={null}
  curl -X POST http://localhost:8100/v1/forget \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer hk_..." \
    -d '{"project_id": "prj_support", "subject_id": "usr_42", "mode": "delete"}'
  ```

  ```python Python (SDK) theme={null}
  client.forget(project_id="prj_support", subject_id="usr_42", mode="delete")
  ```

  ```typescript TypeScript (SDK) theme={null}
  await client.forget({ projectId: "prj_support", subjectId: "usr_42", mode: "delete" });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "ok",
    "mode": "delete",
    "scope": "subject",
    "forget_id": "b1e2f3a4-...",
    "facts_disabled": 0,
    "facts_deleted": 12,
    "conflict_sets_deleted": 1,
    "events_deleted": 34,
    "traces_deleted": 5
  }
  ```
</ResponseExample>

## Erreurs possibles

`invalid_forget_scope` (422 — ni ou les deux de `fact_id`/`subject_id`, ou
`mode` inconnu), `fact_not_found` (404 — `fact_id` inconnu ou d'un autre
projet).