> ## 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.

# GET /v1/conflicts · POST /v1/conflicts/{id}/resolve

> Lister les contradictions ouvertes et les résoudre

Voir [Conflits](/fr/concepts/conflicts) pour le fonctionnement complet.

## Lister les conflits ouverts

```http theme={null}
GET /v1/conflicts
```

<ParamField query="project_id" type="string" required />

<ParamField query="subject_id" type="string">Optionnel — resserre à un sujet.</ParamField>

<ResponseField name="conflicts" type="ConflictSetOut[]" required>
  Ordonnés par `created_at` croissant (le plus ancien en premier).

  <Expandable title="ConflictSetOut">
    <ResponseField name="id" type="uuid" required />

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

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

    <ResponseField name="fact_ids" type="uuid[]" required />

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

    <ResponseField name="reason" type="string | null" />

    <ResponseField name="created_at" type="datetime" required />

    <ResponseField name="resolved_at" type="datetime | null" />
  </Expandable>
</ResponseField>

<ResponseField name="open_count" type="integer" required>
  Pensé pour du monitoring : alerter sur ce compteur sans parser la liste.
</ResponseField>

<ResponseField name="oldest_open_seconds" type="number | null">
  Âge en secondes du plus ancien conflit encore ouvert.
</ResponseField>

<RequestExample>
  ```bash curl theme={null}
  curl "http://localhost:8100/v1/conflicts?project_id=prj_support" \
    -H "Authorization: Bearer hk_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "conflicts": [{
      "id": "c1a2...",
      "project_id": "prj_support",
      "subject_id": "usr_42",
      "fact_ids": ["f1...", "f2..."],
      "status": "open",
      "reason": "predicate 'invoice_language': {\"language\":\"fr\"} vs {\"language\":\"en\"}",
      "created_at": "2026-08-01T10:05:00+00:00",
      "resolved_at": null
    }],
    "open_count": 1,
    "oldest_open_seconds": 412.7
  }
  ```
</ResponseExample>

***

## Résoudre un conflit

```http theme={null}
POST /v1/conflicts/{conflict_id}/resolve
```

<ParamField path="conflict_id" type="uuid" required />

<ParamField body="project_id" type="string" required />

<ParamField body="keep_fact_id" type="uuid" required>
  Doit appartenir au `ConflictSet` — sinon `fact_not_in_conflict`.
</ParamField>

<ResponseField name="conflict_id" type="uuid" required />

<ResponseField name="status" type="string" required>`"resolved"`</ResponseField>

<ResponseField name="kept_fact_id" type="uuid" required />

<ResponseField name="superseded_fact_ids" type="uuid[]" required>
  Tous les autres faits du set, désormais `superseded`.
</ResponseField>

<ResponseField name="resolved_at" type="datetime" required />

<RequestExample>
  ```bash curl theme={null}
  curl -X POST http://localhost:8100/v1/conflicts/c1a2.../resolve \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer hk_..." \
    -d '{"project_id": "prj_support", "keep_fact_id": "f1..."}'
  ```

  ```python Python (SDK) theme={null}
  client.resolve_conflict("c1a2...", project_id="prj_support", keep_fact_id="f1...")
  ```
</RequestExample>

## Erreurs possibles

`missing_scope` (422 — `project_id` absent en liste), `conflict_not_found`
(404 — inconnu ou d'un autre projet), `conflict_already_resolved` (409),
`fact_not_in_conflict` (422).