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

# Remember Entry

> Store a typed memory entry in the session cache.

Accepts a discriminated union of ``QAEntry``, ``TraceEntry``,
``FeedbackEntry``, or ``SkillRunEntry`` and dispatches to the
matching ``remember`` path. Session-backed entries require
``session_id``; ``SkillRunEntry`` can persist with or without one.

## Response
The returned ``RememberResult`` includes ``entry_type`` and
``entry_id`` — the ``qa_id``/``trace_id`` returned by the cache
(or the ``qa_id`` a feedback was attached to). Use this to chain
feedback to a freshly stored QA.



## OpenAPI

````yaml /cognee_openapi_spec.json post /api/v1/remember/entry
openapi: 3.1.0
info:
  title: Cognee API
  description: Cognee API with Bearer token and Cookie auth
  version: 1.0.0
servers:
  - url: https://api.cognee.ai
    description: Production server (full functionality)
  - url: http://localhost:8000
    description: Local development server (requires local setup)
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: activity
    description: ''
  - name: add
    description: Data ingestion endpoints for adding text, files, and structured data.
  - name: agent connections
    description: ''
  - name: agent management
    description: ''
  - name: auth
    description: >-
      Authentication endpoints for user registration, login, and token
      management.
  - name: checks
    description: ''
  - name: cognify
    description: >-
      Knowledge processing endpoints to transform raw data into knowledge
      graphs.
  - name: configuration
    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: ''
  - name: health
    description: ''
  - name: improve
    description: ''
  - name: integrations
    description: ''
  - name: llm
    description: ''
  - name: memify
    description: ''
  - name: ontologies
    description: ''
  - name: permissions
    description: Permission management for multi-user access control.
  - name: recall
    description: ''
  - name: remember
    description: ''
  - name: responses
    description: Response generation endpoints using the knowledge graph.
  - name: schema
    description: ''
  - name: search
    description: Search endpoints for querying the knowledge graph.
  - name: sessions
    description: ''
  - name: settings
    description: Configuration endpoints for managing Cognee settings.
  - name: skills
    description: ''
  - name: slack
    description: ''
  - name: sync
    description: ''
  - name: update
    description: ''
  - name: users
    description: User management endpoints.
  - name: visualize
    description: Graph visualization endpoints.
paths:
  /api/v1/remember/entry:
    post:
      tags:
        - remember
      summary: Remember Entry
      description: |-
        Store a typed memory entry in the session cache.

        Accepts a discriminated union of ``QAEntry``, ``TraceEntry``,
        ``FeedbackEntry``, or ``SkillRunEntry`` and dispatches to the
        matching ``remember`` path. Session-backed entries require
        ``session_id``; ``SkillRunEntry`` can persist with or without one.

        ## Response
        The returned ``RememberResult`` includes ``entry_type`` and
        ``entry_id`` — the ``qa_id``/``trace_id`` returned by the cache
        (or the ``qa_id`` a feedback was attached to). Use this to chain
        feedback to a freshly stored QA.
      operationId: remember_entry_api_v1_remember_entry_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RememberEntryRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Remember Entry Api V1 Remember Entry Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    RememberEntryRequest:
      properties:
        entry:
          oneOf:
            - $ref: '#/components/schemas/QAEntry'
            - $ref: '#/components/schemas/TraceEntry'
            - $ref: '#/components/schemas/FeedbackEntry'
            - $ref: '#/components/schemas/SkillRunEntry'
          title: Entry
          discriminator:
            propertyName: type
            mapping:
              feedback:
                $ref: '#/components/schemas/FeedbackEntry'
              qa:
                $ref: '#/components/schemas/QAEntry'
              skill_run:
                $ref: '#/components/schemas/SkillRunEntry'
              trace:
                $ref: '#/components/schemas/TraceEntry'
        dataset_name:
          type: string
          title: Dataset Name
          default: main_dataset
        dataset_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Dataset Id
          description: >-
            UUID of an existing writable dataset. Takes precedence over
            dataset_name and is required to target a shared dataset by ID.
        session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Session Id
          description: >-
            Required for qa/trace/feedback entries; optional for skill_run
            entries.
          examples:
            - claude-code-1718000000
        skill_improvement:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Skill Improvement
      type: object
      required:
        - entry
      title: RememberEntryRequest
      description: |-
        JSON body for the typed-entry remember endpoint.

        ``entry`` is a discriminated union — set ``type`` to ``qa``,
        ``trace``, ``feedback``, or ``skill_run`` and include the
        corresponding fields.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    QAEntry:
      properties:
        type:
          type: string
          const: qa
          title: Type
          default: qa
        question:
          type: string
          title: Question
          examples:
            - What is the capital of France?
        answer:
          type: string
          title: Answer
          examples:
            - The capital of France is Paris.
        context:
          type: string
          title: Context
          default: ''
          examples:
            - Retrieved from geography_notes.md
        feedback_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Feedback Text
        feedback_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Feedback Score
        used_graph_element_ids:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Used Graph Element Ids
      type: object
      required:
        - question
        - answer
      title: QAEntry
      description: |-
        A Q&A turn stored in the session cache.

        Represents a user question + assistant answer with optional
        retrieval context. Dispatched to ``SessionManager.add_qa``.
    TraceEntry:
      properties:
        type:
          type: string
          const: trace
          title: Type
          default: trace
        origin_function:
          type: string
          title: Origin Function
          description: Name of the tool/function whose execution this trace step records.
          examples:
            - search_codebase
        status:
          type: string
          enum:
            - success
            - error
          title: Status
          default: success
        method_params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Method Params
        method_return_value:
          anyOf:
            - {}
            - type: 'null'
          title: Method Return Value
        memory_query:
          type: string
          title: Memory Query
          default: ''
        memory_context:
          type: string
          title: Memory Context
          default: ''
        error_message:
          type: string
          title: Error Message
          default: ''
        generate_feedback_with_llm:
          type: boolean
          title: Generate Feedback With Llm
          default: false
      type: object
      required:
        - origin_function
      title: TraceEntry
      description: |-
        One step of an agent trace.

        Structured representation of a tool/function call — origin,
        outcome, parameters, return value. Dispatched to
        ``SessionManager.add_agent_trace_step``.
    FeedbackEntry:
      properties:
        type:
          type: string
          const: feedback
          title: Type
          default: feedback
        qa_id:
          type: string
          title: Qa Id
          description: >-
            entry_id returned by a previous qa remember call — use it to chain
            feedback to that QA.
          examples:
            - c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f
        feedback_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Feedback Text
        feedback_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Feedback Score
      type: object
      required:
        - qa_id
      title: FeedbackEntry
      description: |-
        Feedback attached to an existing QA entry.

        Semantically an update rather than a new memory — carried through
        remember() for API minimalism. Dispatched to
        ``SessionManager.add_feedback``.
    SkillRunEntry:
      properties:
        type:
          type: string
          const: skill_run
          title: Type
          default: skill_run
        run_id:
          type: string
          title: Run Id
        selected_skill_id:
          type: string
          title: Selected Skill Id
        task_text:
          type: string
          title: Task Text
          default: ''
        result_summary:
          type: string
          title: Result Summary
          default: ''
        success_score:
          anyOf:
            - type: number
            - type: 'null'
          title: Success Score
        feedback:
          type: number
          title: Feedback
          default: 0
        error_type:
          type: string
          title: Error Type
          default: ''
        error_message:
          type: string
          title: Error Message
          default: ''
        started_at_ms:
          type: integer
          title: Started At Ms
          default: 0
        latency_ms:
          type: integer
          title: Latency Ms
          default: 0
        candidate_skill_ids:
          items:
            type: string
          type: array
          title: Candidate Skill Ids
        task_pattern_id:
          type: string
          title: Task Pattern Id
          default: ''
        router_version:
          type: string
          title: Router Version
          default: ''
        tool_trace:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Tool Trace
        node_set:
          type: string
          title: Node Set
          default: skills
      type: object
      required:
        - selected_skill_id
      title: SkillRunEntry
      description: |-
        A persisted execution record for a skill.

        This is graph-backed rather than session-cache-backed. It lets agents
        report explicit skill quality signals through ``cognee.remember()``
        without adding another public API surface.
    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

````