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

# Add memory context data

> This endpoint adds memory (chat history) as context.



## OpenAPI

````yaml POST /api/v1/context/memory/add
openapi: 3.1.0
info:
  title: Alchemyst AI API v1 documentation
  version: 1.0.0
  description: v1 API documentation for Alchemyst AI
servers:
  - url: https://platform-backend.getalchemystai.com
    description: production
security:
  - bearerAuth: []
tags: []
paths:
  /api/v1/context/memory/add:
    post:
      tags:
        - context
      summary: Add memory context data
      description: This endpoint adds memory (chat history) as context.
      operationId: addContextAsMemory
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - sessionId
                - contents
              properties:
                sessionId:
                  type: string
                  description: The ID of the session
                contents:
                  type: array
                  description: >-
                    Array of content objects. Each object must contain at least
                    the 'content' field. Additional properties are allowed.
                  items:
                    type: object
                    required:
                      - content
                    properties:
                      content:
                        type: string
                        description: The content of the memory message
                      metadata:
                        type: object
                        description: Additional metadata for the message (optional)
                        properties:
                          messageId:
                            type: string
                            description: Unique message ID
                    additionalProperties: true
                metadata:
                  type: object
                  description: >-
                    Optional metadata for the memory context. Defaults to
                    ["default"] if not provided.
                  properties:
                    groupName:
                      type: array
                      items:
                        type: string
                      description: >-
                        Optional group names for the memory context. Defaults to
                        ["default"] if not provided.
                      default:
                        - default
                  additionalProperties: true
            examples:
              minimal:
                summary: Minimal required fields only
                value:
                  sessionId: support-thread-TCK-1234
                  contents:
                    - content: Customer asked about pricing for the Scale plan.
              withMessageMetadata:
                summary: With message-level metadata
                value:
                  sessionId: support-thread-TCK-1234
                  contents:
                    - content: Customer asked about pricing for the Scale plan.
                      metadata:
                        messageId: msg_001
                    - content: Agent responded with pricing details for Scale plan.
                      metadata:
                        messageId: msg_002
              withGroupMetadata:
                summary: With custom group names
                value:
                  sessionId: support-thread-TCK-1234
                  contents:
                    - content: Customer asked about pricing for the Scale plan.
                  metadata:
                    groupName:
                      - support
                      - pricing
      responses:
        '201':
          description: Memory context added successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextAddSuccess'
              example:
                success: true
                context_id: ctx_01HXYZABC
                processed_documents: 1
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error:
                  code: INVALID_REQUEST
                  message: sessionId field is required
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ContextAddSuccess:
      type: object
      required:
        - success
        - context_id
      properties:
        success:
          type: boolean
          example: true
        context_id:
          type: string
          example: ctx_01HXYZABC
        processed_documents:
          type: number
          example: 2
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Invalid job id
        status:
          type: number
          example: 400
        error:
          type: object
          example: Error details
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: UNAUTHORIZED
            message:
              type: string
              example: User not authenticated
            details:
              type: object
              additionalProperties: true
        statusText:
          type: string
          description: Error message (detailed in debug mode)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````