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

# Create a new memory document

> Creates a new document in the specified memory.



## OpenAPI

````yaml post /v2/memory-stores/{memory_store_key}/memories/{memory_entity_id}/documents
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/memory-stores/{memory_store_key}/memories/{memory_entity_id}/documents:
    post:
      tags:
        - Memory Stores
      summary: Create a new memory document
      description: Creates a new document in the specified memory.
      operationId: CreateMemoryDocument
      parameters:
        - schema:
            type: string
            description: The unique key identifier of the memory store
          required: true
          description: The unique key identifier of the memory store
          name: memory_store_key
          in: path
        - schema:
            type: string
            description: The unique entity_id provided during the memory store creation
          required: true
          description: The unique entity_id provided during the memory store creation
          name: memory_entity_id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                text:
                  type: string
                  minLength: 1
                  description: The content of the memory document (whitespace trimmed).
                metadata:
                  type: object
                  additionalProperties:
                    type: string
                  description: >-
                    Flexible key-value pairs for custom filtering and
                    categorization. Clients can add arbitrary string metadata to
                    enable future filtering of memory documents based on their
                    specific needs (e.g., document type, source, topic,
                    relevance score, or any custom taxonomy).
              required:
                - text
      responses:
        '201':
          description: Memory document successfully created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  _id:
                    type: string
                  memory_id:
                    type: string
                  store_id:
                    type: string
                  text:
                    type: string
                    minLength: 1
                    description: The content of the memory document (whitespace trimmed).
                  created:
                    type: string
                  updated:
                    type: string
                  created_by_id:
                    type: string
                  updated_by_id:
                    type: string
                  workspace_id:
                    type: string
                  metadata:
                    type: object
                    additionalProperties:
                      type: string
                    default: {}
                    description: >-
                      Flexible key-value pairs for custom filtering and
                      categorization. Clients can add arbitrary string metadata
                      to enable future filtering of memory documents based on
                      their specific needs (e.g., document type, source, topic,
                      relevance score, or any custom taxonomy).
                required:
                  - _id
                  - memory_id
                  - store_id
                  - text
                  - created
                  - updated
                  - workspace_id
        '400':
          description: Bad Request - Invalid document data provided
        '401':
          description: Unauthorized - Bearer token is missing or invalid
        '403':
          description: Forbidden - Insufficient permissions to create documents
        '404':
          description: Memory not found
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````