Choose Fact

Accept one competing fact and mark the conflict resolved.

Repeating a choice over the same facts is idempotent; repeated after a review listed new evidence, it also rejects that evidence. Choosing another fact revises the decision. Automatic conflict review preserves the user decision. Rejected source facts remain stored for inspection, but normal retrieval uses the selected information. A caller without write permission on the dataset gets 403.

Path Parameters

• conflict_id (UUID): Id of the FactConflict to resolve (from GET /api/v1/conflicts). It must exist in the dataset named by datasetId; otherwise the request returns 404.

Request Parameters

• datasetId (UUID): Dataset containing the conflict. Requires write permission.
• reason (Optional[str]): Optional explanation of the decision.
• selectedFactId (UUID): Fact id from the conflict’s facts list to accept; any other id returns 422.

POST /api/v1/conflicts/{conflict_id}/resolve

Choose Fact

cURL

curl --request POST \
  --url https://{tenant}.aws.cognee.ai/api/v1/conflicts/{conflict_id}/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "selectedFactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "aboutId": "<string>",
  "attribute": "<string>",
  "kind": "time_varying",
  "status": "resolved",
  "text": "<string>",
  "facts": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "text": "<string>",
      "sourceId": "<string>",
      "targetId": "<string>",
      "relationship": "<string>",
      "status": "<string>",
      "sources": [
        {}
      ]
    }
  ],
  "resolutionSource": "review",
  "selectedFactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "selectedFact": "<string>",
  "resolvedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resolvedAt": "<string>",
  "resolutionReason": "<string>",
  "writePending": false
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conflict_id · string<uuid> · required

Body

application/json

datasetId · string<uuid> · required

Dataset containing the conflict. Requires write permission.

selectedFactId · string<uuid> · required

Fact id from the conflict's facts list to accept.

reason · string | null

Optional explanation of the decision.

Response

200

application/json

Successful Response

id · string<uuid> · required

datasetId · string<uuid> · required

aboutId · string · required

attribute · string · required

kind · enum<string> · required

Available options: time_varying, fixed

status · enum<string> · required

Available options: resolved, unresolved

text · string · required

facts · ConflictFact · object[]

Show child attributes

resolutionSource · enum<string> · default: review

Available options: review, user

selectedFactId · string<uuid> | null

selectedFact · string | null

resolvedBy · string<uuid> | null

resolvedAt · string | null

resolutionReason · string | null

writePending · boolean · default: false