Get Conflicts

List conflicts, candidate fact ids, source evidence and previous decisions.

A dataset with no matching FactConflict nodes returns an empty list. A caller without read permission on the dataset gets 403.

Query Parameters

• dataset_id (UUID): Dataset to inspect. Requires read permission.
• status (Optional[Literal[‘resolved’, ‘unresolved’]]): Restricts the listing to conflicts in that state; omitted, conflicts in both states are returned. One of: ‘resolved’, ‘unresolved’.

GET /api/v1/conflicts

Get Conflicts

cURL

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/conflicts \
  --header 'Authorization: Bearer <token>'

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.

Query Parameters

dataset_id · string<uuid> · required

Dataset to inspect. Requires read permission.

status · enum<string> | null

Available options: resolved, unresolved

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