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

# List Agent Memory Conflicts

> Returns a paginated list of memory conflicts among an agent's facts

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

When MemoryLake extracts facts for an agent, it compares new facts against the agent's existing facts. If a contradiction is detected, it is recorded as a **memory conflict**. Use this endpoint to list an agent's conflicts, newest first, so you can surface them to users for review.

You can filter by resolution status to show only unresolved conflicts that need attention, or only resolved ones for audit purposes. For conflicts within a project's knowledge, use [List Memory Conflicts](/features/memorylake/api-reference/v3-conflicts/list-conflicts) instead.

<Note>
  **Permission required:** `workspace_agent:fact_conflict_read`
</Note>

### Path Parameters

<ParamField path="workspaceId" type="string" required>
  Workspace ID
</ParamField>

<ParamField path="agentId" type="string" required>
  Agent ID
</ParamField>

### Query Parameters

<ParamField query="resolved" type="boolean">
  Filter by resolution status. Pass `true` for resolved conflicts only, `false` for unresolved only. Omit to return both.
</ParamField>

<ParamField query="page_size" type="integer" default="20">
  Number of conflicts to return per page. Range: 1–100.
</ParamField>

<ParamField query="continuation_token" type="string">
  Token from a previous response to fetch the next page of results
</ParamField>

<RequestExample>
  ```bash Unresolved conflicts theme={null}
  curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/memories/conflicts?resolved=false&page_size=20' \
    -H 'Authorization: Bearer sk_xxxxxx'
  ```

  ```bash All conflicts theme={null}
  curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/memories/conflicts?page_size=50' \
    -H 'Authorization: Bearer sk_xxxxxx'
  ```
</RequestExample>

### Response

<ResponseField name="data" type="object">
  <Expandable title="Paginated conflict list">
    <ResponseField name="items" type="array">
      Array of conflict objects

      <Expandable title="Conflict object">
        <ResponseField name="id" type="string">Conflict identifier</ResponseField>
        <ResponseField name="name" type="string">Short title describing the conflict</ResponseField>
        <ResponseField name="description" type="string">Detailed explanation of the contradiction</ResponseField>
        <ResponseField name="category" type="string">Conflict category: `m2m` (fact vs. fact) or `m2d` (fact vs. document)</ResponseField>
        <ResponseField name="resolved" type="boolean">Whether the conflict has been resolved</ResponseField>
        <ResponseField name="resolve" type="object">Resolution record. Present only when the conflict has been resolved; `null` otherwise. See [Get Agent Memory Conflict](/features/memorylake/api-reference/v3-conflicts/get-agent-conflict) for the full structure.</ResponseField>
        <ResponseField name="stale" type="boolean">Whether an involved fact changed after the conflict was detected. Stale conflicts may no longer be accurate.</ResponseField>
        <ResponseField name="conflict_type" type="string">Conflict type: `logical` or `knowledge`</ResponseField>
        <ResponseField name="fact_ids" type="array">IDs of the facts involved in the conflict</ResponseField>

        <ResponseField name="fact_snapshots" type="array">
          Snapshots of the involved facts at detection time

          <Expandable title="Fact snapshot">
            <ResponseField name="fact_id" type="string">Fact identifier</ResponseField>
            <ResponseField name="fact_text" type="string">Fact text at detection time</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="file_chunks" type="array">
          Document excerpts cited by a fact-vs-document conflict

          <Expandable title="File chunk">
            <ResponseField name="text" type="string">The conflicting excerpt text</ResponseField>
            <ResponseField name="document_id" type="string">ID of the document this excerpt belongs to</ResponseField>
            <ResponseField name="document_name" type="string">Display name of the document</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="created_at" type="string">When the conflict was first detected</ResponseField>
        <ResponseField name="updated_at" type="string">When the conflict was last updated</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="continuation_token" type="string">Token to retrieve the next page of results. Absent when there are no more pages.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success (200) theme={null}
  {
    "success": true,
    "data": {
      "items": [
        {
          "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": false,
          "resolve": null,
          "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-20T14:30:00Z"
        }
      ],
      "continuation_token": null
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.