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

# List Merge Conflicts

> List memory merge conflicts for a user with filtering and sorting.

When the system detects conflicting or contradictory memories, it creates merge conflicts that
require user resolution. This endpoint retrieves all such conflicts with filtering options.

**Path Parameters:**
- `custom_user_id` (str): Unique identifier for the user

**Query Parameters:**
- `offset` (int): Number of records to skip for pagination. Default: 0
- `limit` (int): Maximum records to return. Range: 1-100. Default: 10
- `status` (MemoryMergeConflictStatus): Filter by status (PENDING, PROCESSING, PROCESSED, IN_QUEUE). Optional
- `sort_by` (str): Sort field. Options: created_at, resolved_at. Default: created_at
- `sort_order` (str): Sort order. Options: asc, desc. Default: desc

**Returns:**
- `conflicts` (List[MergeConflictInfo]): List of merge conflicts with clarifying questions and conflicting memory details
- `total` (int): Total number of conflicts matching the filters
- `has_more` (bool): Whether more conflicts are available beyond the current page



## OpenAPI

````yaml https://api.recallrai.com/api/openapi.json get /api/v1/users/{custom_user_id}/merge-conflicts
openapi: 3.1.0
info:
  title: api-backend
  description: This powers the Recallr AI API Backend
  version: 0.1.0
servers:
  - url: https://api.recallrai.com
    description: Production server
security: []
paths:
  /api/v1/users/{custom_user_id}/merge-conflicts:
    get:
      tags:
        - Merge Conflicts
      summary: List Merge Conflicts
      description: >-
        List memory merge conflicts for a user with filtering and sorting.


        When the system detects conflicting or contradictory memories, it
        creates merge conflicts that

        require user resolution. This endpoint retrieves all such conflicts with
        filtering options.


        **Path Parameters:**

        - `custom_user_id` (str): Unique identifier for the user


        **Query Parameters:**

        - `offset` (int): Number of records to skip for pagination. Default: 0

        - `limit` (int): Maximum records to return. Range: 1-100. Default: 10

        - `status` (MemoryMergeConflictStatus): Filter by status (PENDING,
        PROCESSING, PROCESSED, IN_QUEUE). Optional

        - `sort_by` (str): Sort field. Options: created_at, resolved_at.
        Default: created_at

        - `sort_order` (str): Sort order. Options: asc, desc. Default: desc


        **Returns:**

        - `conflicts` (List[MergeConflictInfo]): List of merge conflicts with
        clarifying questions and conflicting memory details

        - `total` (int): Total number of conflicts matching the filters

        - `has_more` (bool): Whether more conflicts are available beyond the
        current page
      operationId: list_merge_conflicts_api_v1_users__custom_user_id__merge_conflicts_get
      parameters:
        - name: custom_user_id
          in: path
          required: true
          schema:
            type: string
            description: Custom user ID to list merge conflicts for
            title: Custom User Id
          description: Custom user ID to list merge conflicts for
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Number of records to skip
            default: 0
            title: Offset
          description: Number of records to skip
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Maximum number of records to return
            default: 10
            title: Limit
          description: Maximum number of records to return
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/MemoryMergeConflictStatus'
              - type: 'null'
            description: Filter by status
            title: Status
          description: Filter by status
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            description: Sort field (created_at, resolved_at)
            default: created_at
            title: Sort By
          description: Sort field (created_at, resolved_at)
        - name: sort_order
          in: query
          required: false
          schema:
            type: string
            description: Sort order (asc, desc)
            default: desc
            title: Sort Order
          description: Sort order (asc, desc)
        - name: X-Recallr-Project-Id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            title: X-Recallr-Project-Id
        - name: X-Recallr-Api-Key
          in: header
          required: true
          schema:
            type: string
            title: X-Recallr-Api-Key
      responses:
        '200':
          description: Merge conflicts listed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMergeConflictsResponse'
        '401':
          description: Authentication required
        '404':
          description: User not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
components:
  schemas:
    MemoryMergeConflictStatus:
      type: string
      enum:
        - PENDING
        - IN_QUEUE
        - RESOLVING
        - RESOLVED
        - FAILED
      title: MemoryMergeConflictStatus
    ListMergeConflictsResponse:
      properties:
        conflicts:
          items:
            $ref: '#/components/schemas/MergeConflictInfo'
          type: array
          title: Conflicts
        total:
          type: integer
          title: Total
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
        - conflicts
        - total
        - has_more
      title: ListMergeConflictsResponse
      description: Response containing list of merge conflicts.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MergeConflictInfo:
      properties:
        conflict_id:
          type: string
          format: uuid
          title: Conflict Id
        project_user_session_id:
          type: string
          format: uuid
          title: Project User Session Id
        proposed_memory_content:
          anyOf:
            - type: string
            - type: 'null'
          title: Proposed Memory Content
        new_memories:
          anyOf:
            - items:
                $ref: '#/components/schemas/MergeConflictNewMemory'
              type: array
            - type: 'null'
          title: New Memories
        conflicting_memories:
          items:
            $ref: '#/components/schemas/MergeConflictConflictingMemory'
          type: array
          title: Conflicting Memories
        clarifying_questions:
          items:
            $ref: '#/components/schemas/MergeConflictQuestion'
          type: array
          title: Clarifying Questions
        status:
          $ref: '#/components/schemas/MemoryMergeConflictStatus'
        resolution_data:
          anyOf:
            - $ref: '#/components/schemas/UserResponseMergeConflictQuestionAnswers'
            - type: 'null'
        created_at:
          type: string
          format: date-time
          title: Created At
        resolved_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Resolved At
      type: object
      required:
        - conflict_id
        - project_user_session_id
        - conflicting_memories
        - clarifying_questions
        - status
        - resolution_data
        - created_at
        - resolved_at
      title: MergeConflictInfo
      description: Information about a merge conflict.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    MergeConflictNewMemory:
      properties:
        memory_id:
          type: string
          format: uuid
          title: Memory Id
        content:
          type: string
          title: Content
        event_date_start:
          type: string
          format: date-time
          title: Event Date Start
        event_date_end:
          type: string
          format: date-time
          title: Event Date End
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - memory_id
        - content
        - event_date_start
        - event_date_end
        - created_at
      title: MergeConflictNewMemory
      description: A resolved memory from a merge conflict.
    MergeConflictConflictingMemory:
      properties:
        memory_id:
          type: string
          format: uuid
          title: Memory Id
        content:
          type: string
          title: Content
        reason:
          type: string
          title: Reason
        event_date_start:
          type: string
          format: date-time
          title: Event Date Start
        event_date_end:
          type: string
          format: date-time
          title: Event Date End
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - memory_id
        - content
        - reason
        - event_date_start
        - event_date_end
        - created_at
      title: MergeConflictConflictingMemory
      description: Memory involved in a merge conflict.
    MergeConflictQuestion:
      properties:
        question:
          type: string
          title: Question
        options:
          items:
            type: string
          type: array
          title: Options
      type: object
      required:
        - question
        - options
      title: MergeConflictQuestion
      description: Generated clarifying question for merge conflict resolution.
    UserResponseMergeConflictQuestionAnswers:
      properties:
        question_answers:
          items:
            $ref: '#/components/schemas/UserResponseMergeConflictQuestion'
          type: array
          title: Question Answers
      type: object
      required:
        - question_answers
      title: UserResponseMergeConflictQuestionAnswers
    UserResponseMergeConflictQuestion:
      properties:
        question:
          type: string
          title: Question
        answer:
          type: string
          title: Answer
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
      type: object
      required:
        - question
        - answer
      title: UserResponseMergeConflictQuestion

````