---
title: "Create memory store"
method: POST
path: "/v2/memory-stores"
tags: ["Memory Stores"]
---

# Create memory store

`POST /v2/memory-stores`

## Request body

- CreateMemoryStoreRequest
  - `key` string, required — The unique key of the memory store. The key is unique and inmmutable and cannot be repeated within the same workspace.
  - `embedding_config` MemoryStoreEmbeddingConfig, required
    - `model` string, required — The embeddings model to use for the knowledge base in the format "provider/model" for public models or "workspaceKey@provider/model" for private workspace models. This model will be used to embed the chunks when they are added to the knowledge base. Refer to the (Supported models)[/docs/proxy/supported-models] to browse available models.
  - `description` string, required
  - `ttl` number, nullable
  - `path` string, required — Entity storage path. With workspace-level API keys, the first element identifies the project. With project-level API keys, the path is relative to that project.

## Response `201`

Memory store successfully created with the specified configuration.

- MemoryStore
  - `key` string, required — The unique key of the memory store. The key is unique and inmmutable and cannot be repeated within the same workspace.
  - `description` string, required — The description of the memory store. Be as precise as possible to help the AI to understand the purpose of the memory store.
  - `created_by_id` string, nullable — The user ID of the creator
  - `updated_by_id` string, nullable — The user ID of the last updater
  - `created` string, required — The creation date of the memory store
  - `updated` string, required — The last update date of the memory store
  - `ttl` number, nullable
  - `embedding_config` MemoryStoreEmbeddingConfig, required
    - `model` string, required — The embeddings model to use for the knowledge base in the format "provider/model" for public models or "workspaceKey@provider/model" for private workspace models. This model will be used to embed the chunks when they are added to the knowledge base. Refer to the (Supported models)[/docs/proxy/supported-models] to browse available models.
  - `_id` string, required — The unique identifier of the memory store

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/2cd7e7f7bcb4/schema)