curl -X POST 'https://api.anthropic.com/v1/memory_stores?beta=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name"
}'

# POST /v1/memory_stores?beta=true (Claude API)
Base URL: https://api.anthropic.com
Auth: x-api-key; Anthropic API key; required.
Status: Beta.
Request formats: application/json.
Last verified: 2026-10-20

> Create a memory store

## Critical Gotchas
* Authentication uses the `x-api-key` header and requests also require an `anthropic-version` header.
* The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

## cURL
curl -X POST 'https://api.anthropic.com/v1/memory_stores?beta=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | Human-readable name for the store. Required; 1–255 characters; no control cha... |
| description | body | string | No | Free-text description of what the store contains, up to 1024 characters. Incl... |
| metadata | body | object | No | Arbitrary key-value tags for your own bookkeeping (such as the end user a sto... |

## Response example
{"type":"memory_store","id":"string"}

---
Need an API key? Get one at https://console.anthropic.com/settings/keys

POST

POST /v1/memory_stores?beta=true — Claude API

Beta

Anthropic API key (required); https://api.anthropic.com

Claude API

Create a memory store

Base URL: https://api.anthropic.com
Auth: x-api-key: <ANTHROPIC_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 250 tokens · Vary: Accept

Critical gotchas

Authentication uses the x-api-key header and requests also require an anthropic-version header.

The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

cURL

curl -X POST 'https://api.anthropic.com/v1/memory_stores?beta=true' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01' \  -H 'Content-Type: application/json' \  -d '{  "name": "example-name"}'

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	Human-readable name for the store. Required; 1–255 characters; no control characters. The mount-path slug under `/mnt/memory/` is derived from this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be unique within a workspace.
description	body	string	No	Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent.
metadata	body	object	No	Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Not visible to the agent.

Response 200 OK

{
  "type": "memory_store",
  "id": "string",
  "name": "string",
  "description": "string",
  "created_at": "2026-09-03T00:00:00Z",
  "updated_at": "2026-09-03T00:00:00Z",
  "metadata": {},
  "archived_at": "2026-09-03T00:00:00Z"
}

Get a free Claude API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.