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

# 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.



## OpenAPI

````yaml /cognee_openapi_spec.json post /api/v1/conflicts/{conflict_id}/resolve
openapi: 3.1.0
info:
  title: Cognee API
  description: Cognee API with Bearer token and Cookie auth
  version: 1.0.0
servers:
  - url: https://{tenant}.aws.cognee.ai
    description: 'Cognee Cloud: your tenant pod, named in the platform.cognee.ai dashboard'
    variables:
      tenant:
        default: your-tenant
        description: Your tenant name, shown in the Cognee Cloud dashboard
  - url: http://localhost:8000
    description: 'Self-hosted: a locally running cognee server'
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: activity
    description: >-
      Activity endpoints for inspecting pipeline runs, traced spans, tenant
      users, agents, and dataset exports.
  - name: add
    description: Data ingestion endpoints for adding text, files, and structured data.
  - name: agent connections
    description: >-
      Endpoints for registering, unregistering, and inspecting agent connections
      to the instance.
  - name: agent management
    description: Endpoints for creating, listing, retrieving, and deleting agents.
  - name: auth
    description: >-
      Authentication endpoints for user registration, login, and token
      management.
  - name: checks
    description: >-
      Diagnostic endpoint for validating a Cognee Cloud API key supplied in the
      X-Api-Key header.
  - name: cognify
    description: >-
      Knowledge processing endpoints to transform raw data into knowledge
      graphs.
  - name: configuration
    description: >-
      Endpoints for storing, retrieving, and listing a user's saved
      configurations.
  - name: conflicts
    description: ''
  - name: datasets
    description: Dataset management endpoints for listing, creating, and deleting datasets.
  - name: delete
    description: Data deletion endpoints (deprecated — use datasets endpoints instead).
  - name: forget
    description: Endpoint for removing data from the knowledge graph.
  - name: health
    description: Liveness, readiness, and component health checks.
  - name: improve
    description: Endpoint for enriching and improving an existing knowledge graph.
  - name: integrations
    description: >-
      Endpoints for connecting, provisioning, and disconnecting OAuth providers
      and plugins.
  - name: llm
    description: >-
      LLM-backed endpoints for inferring graph schemas and generating custom
      extraction prompts.
  - name: memify
    description: >-
      Endpoint for running enrichment pipelines over existing graphs or supplied
      data.
  - name: ontologies
    description: >-
      Endpoints for uploading, listing, and deleting ontology files used during
      cognify.
  - name: permissions
    description: Permission management for multi-user access control.
  - name: recall
    description: >-
      Endpoints for querying the knowledge graph and reviewing past recall
      history.
  - name: remember
    description: >-
      Endpoints for ingesting data into the knowledge graph and storing session
      memory entries.
  - name: responses
    description: Response generation endpoints using the knowledge graph.
  - name: schema
    description: >-
      Schema inspection endpoints for a dataset's derived schema inventory and
      the caller-wide memory provenance graph.
  - name: search
    description: Search endpoints for querying the knowledge graph.
  - name: sessions
    description: >-
      Endpoints for listing sessions and reporting usage, cost, and token
      statistics.
  - name: settings
    description: Configuration endpoints for managing Cognee settings.
  - name: skills
    description: >-
      Skill management endpoints for ingesting, listing, retrieving, and
      deleting dataset skills, plus read-only retrieval of improvement
      proposals.
  - name: slack
    description: >-
      Endpoints for listing workspace channels, setting channel allowlists, and
      linking Slack accounts.
  - name: sync
    description: Endpoints for syncing local data to Cognee Cloud and checking sync status.
  - name: update
    description: Endpoint for updating existing data in a dataset.
  - name: users
    description: User management endpoints.
  - name: validate
    description: >-
      Diagnostic endpoint for checking consistency between a dataset's graph and
      vector stores.
  - name: visualize
    description: Graph visualization endpoints.
paths:
  /api/v1/conflicts/{conflict_id}/resolve:
    post:
      tags:
        - conflicts
      summary: Choose Fact
      description: >-
        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.
      operationId: choose_fact_api_v1_conflicts__conflict_id__resolve_post
      parameters:
        - name: conflict_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Conflict Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveConflictRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    ResolveConflictRequest:
      properties:
        datasetId:
          type: string
          format: uuid
          title: Datasetid
          description: Dataset containing the conflict. Requires write permission.
        selectedFactId:
          type: string
          format: uuid
          title: Selectedfactid
          description: Fact id from the conflict's facts list to accept.
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
          description: Optional explanation of the decision.
      type: object
      required:
        - datasetId
        - selectedFactId
      title: ResolveConflictRequest
    ConflictDetail:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        datasetId:
          type: string
          format: uuid
          title: Datasetid
        aboutId:
          type: string
          title: Aboutid
        attribute:
          type: string
          title: Attribute
        kind:
          type: string
          enum:
            - time_varying
            - fixed
          title: Kind
        status:
          type: string
          enum:
            - resolved
            - unresolved
          title: Status
        text:
          type: string
          title: Text
        facts:
          items:
            $ref: '#/components/schemas/ConflictFact'
          type: array
          title: Facts
        resolutionSource:
          type: string
          enum:
            - review
            - user
          title: Resolutionsource
          default: review
        selectedFactId:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Selectedfactid
        selectedFact:
          anyOf:
            - type: string
            - type: 'null'
          title: Selectedfact
        resolvedBy:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Resolvedby
        resolvedAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Resolvedat
        resolutionReason:
          anyOf:
            - type: string
            - type: 'null'
          title: Resolutionreason
        writePending:
          type: boolean
          title: Writepending
          default: false
      type: object
      required:
        - id
        - datasetId
        - aboutId
        - attribute
        - kind
        - status
        - text
      title: ConflictDetail
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ConflictFact:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        text:
          type: string
          title: Text
        sourceId:
          type: string
          title: Sourceid
        targetId:
          type: string
          title: Targetid
        relationship:
          type: string
          title: Relationship
        status:
          type: string
          title: Status
        sources:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Sources
      type: object
      required:
        - id
        - text
        - sourceId
        - targetId
        - relationship
        - status
      title: ConflictFact
    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
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````

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