Get Agent Memory Conflict

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/memories/conflicts/conf-def456' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "id": "conf-def456",
    "name": "Contradicting time zone rule",
    "description": "One fact says to report times in UTC; another says to report them in the customer's local time.",
    "category": "m2m",
    "resolved": true,
    "resolve": {
      "id": "res-1a2b3c4d",
      "strategy": "keep_fact",
      "keep_fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
      "forgotten_fact_ids": ["fact-91263517847b3371a69814787441263f"],
      "created_at": "2025-01-21T09:15:00Z"
    },
    "stale": false,
    "conflict_type": "logical",
    "fact_ids": ["fact-4d89ead72a591e8c6abbf68f99edf5e2", "fact-91263517847b3371a69814787441263f"],
    "fact_snapshots": [
      {
        "fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
        "fact_text": "Reports times in UTC"
      },
      {
        "fact_id": "fact-91263517847b3371a69814787441263f",
        "fact_text": "Reports times in the customer's local time"
      }
    ],
    "file_chunks": [],
    "created_at": "2025-01-20T14:30:00Z",
    "updated_at": "2025-01-21T09:15:00Z"
  }
}

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/memories/conflicts/conf-def456' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "id": "conf-def456",
    "name": "Contradicting time zone rule",
    "description": "One fact says to report times in UTC; another says to report them in the customer's local time.",
    "category": "m2m",
    "resolved": true,
    "resolve": {
      "id": "res-1a2b3c4d",
      "strategy": "keep_fact",
      "keep_fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
      "forgotten_fact_ids": ["fact-91263517847b3371a69814787441263f"],
      "created_at": "2025-01-21T09:15:00Z"
    },
    "stale": false,
    "conflict_type": "logical",
    "fact_ids": ["fact-4d89ead72a591e8c6abbf68f99edf5e2", "fact-91263517847b3371a69814787441263f"],
    "fact_snapshots": [
      {
        "fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
        "fact_text": "Reports times in UTC"
      },
      {
        "fact_id": "fact-91263517847b3371a69814787441263f",
        "fact_text": "Reports times in the customer's local time"
      }
    ],
    "file_chunks": [],
    "created_at": "2025-01-20T14:30:00Z",
    "updated_at": "2025-01-21T09:15:00Z"
  }
}

GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/agents/{agentId}/memories/conflicts/{conflictId}

Returns the complete record for a single conflict, including the fact snapshots captured at detection time, any document excerpts involved, and the resolution record if the conflict has been resolved.

Permission required: workspace_agent:fact_conflict_read

Path Parameters

string

required

Workspace ID

string

required

Agent ID

string

required

Conflict ID

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/memories/conflicts/conf-def456' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

object

Show Conflict object

string

Conflict identifier

string

Short title describing the conflict

string

Detailed explanation of the contradiction

string

Conflict category: m2m (fact vs. fact) or m2d (fact vs. document)

boolean

Whether the conflict has been resolved

object

Resolution record. Present only when the conflict has been resolved; null otherwise.

Show Resolution record

string

Resolution record identifier

string

Strategy that was applied: keep_fact, trust_fact, trust_document, or dismiss

string

The fact kept when strategy is keep_fact

array

IDs of the facts forgotten as part of the resolution

string

When the conflict was resolved

boolean

Whether an involved fact changed after the conflict was detected

string

Conflict type: logical or knowledge

array

IDs of the facts involved in the conflict

array

Snapshots of the involved facts at detection time

Show Fact snapshot

string

Fact identifier

string

Fact text at detection time

array

Document excerpts cited by a fact-vs-document conflict

Show File chunk

string

The conflicting excerpt text

string

ID of the document this excerpt belongs to

string

Display name of the document

string

When the conflict was first detected

string

When the conflict was last updated

{
  "success": true,
  "data": {
    "id": "conf-def456",
    "name": "Contradicting time zone rule",
    "description": "One fact says to report times in UTC; another says to report them in the customer's local time.",
    "category": "m2m",
    "resolved": true,
    "resolve": {
      "id": "res-1a2b3c4d",
      "strategy": "keep_fact",
      "keep_fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
      "forgotten_fact_ids": ["fact-91263517847b3371a69814787441263f"],
      "created_at": "2025-01-21T09:15:00Z"
    },
    "stale": false,
    "conflict_type": "logical",
    "fact_ids": ["fact-4d89ead72a591e8c6abbf68f99edf5e2", "fact-91263517847b3371a69814787441263f"],
    "fact_snapshots": [
      {
        "fact_id": "fact-4d89ead72a591e8c6abbf68f99edf5e2",
        "fact_text": "Reports times in UTC"
      },
      {
        "fact_id": "fact-91263517847b3371a69814787441263f",
        "fact_text": "Reports times in the customer's local time"
      }
    ],
    "file_chunks": [],
    "created_at": "2025-01-20T14:30:00Z",
    "updated_at": "2025-01-21T09:15:00Z"
  }
}

To resolve this conflict, call Resolve Agent Memory Conflict with the strategy you want to apply.

MemoryLake API

Memory Router API

Get Agent Memory Conflict

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response