> ## 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:
  - description: List models available through the AI Router.
    name: Models
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: API keys
    description: >-
      API keys authenticate programmatic access to the workspace. The unified
      key model exposes opaque tokens, per-domain access grants, and budget /
      rate-limit constraints (see ADR 0001 and ADR 0002).
  - name: Budgets
    description: >-
      Budgets govern spend, token usage, and request rate across six scopes:
      workspace, project, identity, api-key, provider, and model. A budget is
      hierarchical and defense-in-depth — every applicable budget is a hard
      gate, and the most restrictive one wins per dimension (see ADR 0007).
  - name: Documentation
    description: >-
      Search the orq.ai documentation. Proxies the workspace's query to the
      hosted docs search index.
  - name: Files
    description: File upload and retrieval operations.
  - name: Identities
    description: >-
      Identities represent end users from your system for usage and engagement
      tracking.
  - name: Projects
    description: Projects organize resources within a workspace
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Embeddings
  - 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.
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
                      - 'null'
                  updated_by_id:
                    type:
                      - string
                      - 'null'
                  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

````