中文 ← MyDocs

Memory Stores

Create a memory store

post /v1/memory_stores

Create a memory store

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Body Parameters

  • name: string

    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: optional string

    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: optional map[string]

    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.

Returns

  • BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }

    A memory_store: a named container for agent memories, scoped to a workspace. Attach a store to a session via resources[] to mount it as a directory the agent can read and write.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

Example

curl https://api.anthropic.com/v1/memory_stores \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "name": "x"
        }'

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "type": "memory_store",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "metadata": {
    "foo": "string"
  }
}

List memory stores

get /v1/memory_stores

List memory stores

Query Parameters

  • "created_at[gte]": optional string

    Return only stores whose created_at is at or after this time (inclusive). Sent on the wire as created_at[gte].

  • "created_at[lte]": optional string

    Return only stores whose created_at is at or before this time (inclusive). Sent on the wire as created_at[lte].

  • include_archived: optional boolean

    When true, archived stores are included in the results. Defaults to false (archived stores are excluded).

  • limit: optional number

    Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted.

  • page: optional string

    Opaque pagination cursor (a page_... value). Pass the next_page value from a previous response to fetch the next page; omit for the first page.

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • data: optional array of BetaManagedAgentsMemoryStore

    Memory stores on this page, newest first. Empty when there are no stores matching the filters.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

  • next_page: optional string

    Opaque cursor for the next page (a page_... value). Pass as page on the next request. null when there are no more results.

Example

curl https://api.anthropic.com/v1/memory_stores \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "name": "name",
      "type": "memory_store",
      "updated_at": "2019-12-27T18:11:19.117Z",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "description": "description",
      "metadata": {
        "foo": "string"
      }
    }
  ],
  "next_page": "next_page"
}

Retrieve a memory store

get /v1/memory_stores/{memory_store_id}

Retrieve a memory store

Path Parameters

  • memory_store_id: string

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }

    A memory_store: a named container for agent memories, scoped to a workspace. Attach a store to a session via resources[] to mount it as a directory the agent can read and write.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "type": "memory_store",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "metadata": {
    "foo": "string"
  }
}

Update a memory store

post /v1/memory_stores/{memory_store_id}

Update a memory store

Path Parameters

  • memory_store_id: string

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Body Parameters

  • description: optional string

    New description for the store, up to 1024 characters. Pass an empty string to clear it.

  • metadata: optional map[string]

    Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.

  • name: optional string

    New human-readable name for the store. 1–255 characters; no control characters. Renaming changes the slug used for the store's mount_path in sessions created after the update.

Returns

  • BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }

    A memory_store: a named container for agent memories, scoped to a workspace. Attach a store to a session via resources[] to mount it as a directory the agent can read and write.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{}'

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "type": "memory_store",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "metadata": {
    "foo": "string"
  }
}

Delete a memory store

delete /v1/memory_stores/{memory_store_id}

Delete a memory store

Path Parameters

  • memory_store_id: string

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsDeletedMemoryStore object { id, type }

    Confirmation that a memory_store was deleted.

    • id: string

      ID of the deleted memory store (a memstore_... identifier). The store and all its memories and versions are no longer retrievable.

    • type: "memory_store_deleted"

      • "memory_store_deleted"

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
    -X DELETE \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "type": "memory_store_deleted"
}

Archive a memory store

post /v1/memory_stores/{memory_store_id}/archive

Archive a memory store

Path Parameters

  • memory_store_id: string

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }

    A memory_store: a named container for agent memories, scoped to a workspace. Attach a store to a session via resources[] to mount it as a directory the agent can read and write.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/archive \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "type": "memory_store",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "metadata": {
    "foo": "string"
  }
}

Domain Types

Beta Managed Agents Deleted Memory Store

  • BetaManagedAgentsDeletedMemoryStore object { id, type }

    Confirmation that a memory_store was deleted.

    • id: string

      ID of the deleted memory store (a memstore_... identifier). The store and all its memories and versions are no longer retrievable.

    • type: "memory_store_deleted"

      • "memory_store_deleted"

Beta Managed Agents Memory Store

  • BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }

    A memory_store: a named container for agent memories, scoped to a workspace. Attach a store to a session via resources[] to mount it as a directory the agent can read and write.

    • id: string

      Unique identifier for the memory store (a memstore_... tagged ID). Use this when attaching the store to a session, or in the {memory_store_id} path parameter of subsequent calls.

    • created_at: string

      A timestamp in RFC 3339 format

    • name: string

      Human-readable name for the store. 1–255 characters. The store's mount-path slug under /mnt/memory/ is derived from this name.

    • type: "memory_store"

      • "memory_store"

    • updated_at: string

      A timestamp in RFC 3339 format

    • archived_at: optional string

      A timestamp in RFC 3339 format

    • description: optional string

      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. Empty string when unset.

    • metadata: optional map[string]

      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. Returned on retrieve/list but not filterable.

Memories

Create a memory

post /v1/memory_stores/{memory_store_id}/memories

Create a memory

Path Parameters

  • memory_store_id: string

Query Parameters

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Body Parameters

  • content: string

    UTF-8 text content for the new memory. Maximum 100 kB (102,400 bytes). Required; pass "" explicitly to create an empty memory.

  • path: string

    Hierarchical path for the new memory, e.g. /projects/foo/notes.md. Must start with /, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, . or .. segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive.

Returns

  • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

    A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

    • id: string

      Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

    • content_sha256: string

      Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

    • content_size_bytes: number

      Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_store_id: string

      ID of the memory store this memory belongs to (a memstore_... value).

    • memory_version_id: string

      ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

    • path: string

      Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

    • type: "memory"

      • "memory"

    • updated_at: string

      A timestamp in RFC 3339 format

    • content: optional string

      The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "content": "content",
          "path": "xx"
        }'

Response

{
  "id": "id",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_store_id": "memory_store_id",
  "memory_version_id": "memory_version_id",
  "path": "path",
  "type": "memory",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "content": "content"
}

List memories

get /v1/memory_stores/{memory_store_id}/memories

List memories

Path Parameters

  • memory_store_id: string

Query Parameters

  • depth: optional number

    Query parameter for depth

  • limit: optional number

    Query parameter for limit

  • order: optional "asc" or "desc"

    Query parameter for order

    • "asc"

    • "desc"

  • order_by: optional string

    Query parameter for order_by

  • page: optional string

    Query parameter for page

  • path_prefix: optional string

    Optional path prefix filter (raw string-prefix match; include a trailing slash for directory-scoped lists). This value appears in request URLs. Do not include secrets or personally identifiable information.

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • data: optional array of BetaManagedAgentsMemoryListItem

    One page of results. Each item is either a memory object or, when depth was set, a memory_prefix rollup marker. Items appear in the requested order_by/order.

    • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

      A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

      • id: string

        Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

      • content_sha256: string

        Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

      • content_size_bytes: number

        Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

      • created_at: string

        A timestamp in RFC 3339 format

      • memory_store_id: string

        ID of the memory store this memory belongs to (a memstore_... value).

      • memory_version_id: string

        ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

      • path: string

        Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

      • type: "memory"

        • "memory"

      • updated_at: string

        A timestamp in RFC 3339 format

      • content: optional string

        The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

    • BetaManagedAgentsMemoryPrefix object { path, type }

      A rolled-up directory marker returned by List memories when depth is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page limit and interleaves with memory items in path order.

      • path: string

        The rolled-up path prefix, including a trailing / (e.g. /projects/foo/). Pass this value as path_prefix on a subsequent list call to drill into the directory.

      • type: "memory_prefix"

        • "memory_prefix"

  • next_page: optional string

    Opaque cursor for the next page (a page_... value), or null if there are no more results. Pass as page on the next request.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "content_sha256": "content_sha256",
      "content_size_bytes": 0,
      "created_at": "2019-12-27T18:11:19.117Z",
      "memory_store_id": "memory_store_id",
      "memory_version_id": "memory_version_id",
      "path": "path",
      "type": "memory",
      "updated_at": "2019-12-27T18:11:19.117Z",
      "content": "content"
    }
  ],
  "next_page": "next_page"
}

Retrieve a memory

get /v1/memory_stores/{memory_store_id}/memories/{memory_id}

Retrieve a memory

Path Parameters

  • memory_store_id: string

  • memory_id: string

Query Parameters

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

    A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

    • id: string

      Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

    • content_sha256: string

      Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

    • content_size_bytes: number

      Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_store_id: string

      ID of the memory store this memory belongs to (a memstore_... value).

    • memory_version_id: string

      ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

    • path: string

      Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

    • type: "memory"

      • "memory"

    • updated_at: string

      A timestamp in RFC 3339 format

    • content: optional string

      The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_store_id": "memory_store_id",
  "memory_version_id": "memory_version_id",
  "path": "path",
  "type": "memory",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "content": "content"
}

Update a memory

post /v1/memory_stores/{memory_store_id}/memories/{memory_id}

Update a memory

Path Parameters

  • memory_store_id: string

  • memory_id: string

Query Parameters

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Body Parameters

  • content: optional string

    New UTF-8 text content for the memory. Maximum 100 kB (102,400 bytes). Omit to leave the content unchanged (e.g., for a rename-only update).

  • path: optional string

    New path for the memory (a rename). Must start with /, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, . or .. segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. The memory's id is preserved across renames. Omit to leave the path unchanged.

  • precondition: optional BetaManagedAgentsPrecondition

    Optimistic-concurrency precondition: the update applies only if the memory's stored content_sha256 equals the supplied value. On mismatch, the request returns memory_precondition_failed_error (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested content and path, the server returns 200 instead of 409.

    • type: "content_sha256"

      • "content_sha256"

    • content_sha256: optional string

      Expected content_sha256 of the stored memory (64 lowercase hexadecimal characters). Typically the content_sha256 returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.

Returns

  • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

    A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

    • id: string

      Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

    • content_sha256: string

      Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

    • content_size_bytes: number

      Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_store_id: string

      ID of the memory store this memory belongs to (a memstore_... value).

    • memory_version_id: string

      ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

    • path: string

      Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

    • type: "memory"

      • "memory"

    • updated_at: string

      A timestamp in RFC 3339 format

    • content: optional string

      The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{}'

Response

{
  "id": "id",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_store_id": "memory_store_id",
  "memory_version_id": "memory_version_id",
  "path": "path",
  "type": "memory",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "content": "content"
}

Delete a memory

delete /v1/memory_stores/{memory_store_id}/memories/{memory_id}

Delete a memory

Path Parameters

  • memory_store_id: string

  • memory_id: string

Query Parameters

  • expected_content_sha256: optional string

    Query parameter for expected_content_sha256

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsDeletedMemory object { id, type }

    Tombstone returned by Delete a memory. The memory's version history persists and remains listable via List memory versions until the store itself is deleted.

    • id: string

      ID of the deleted memory (a mem_... value).

    • type: "memory_deleted"

      • "memory_deleted"

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \
    -X DELETE \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "type": "memory_deleted"
}

Domain Types

Beta Managed Agents Conflict Error

  • BetaManagedAgentsConflictError object { type, message }

    • type: "conflict_error"

      • "conflict_error"

    • message: optional string

Beta Managed Agents Content Sha256 Precondition

  • BetaManagedAgentsContentSha256Precondition object { type, content_sha256 }

    Optimistic-concurrency precondition: the update applies only if the memory's stored content_sha256 equals the supplied value. On mismatch, the request returns memory_precondition_failed_error (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested content and path, the server returns 200 instead of 409.

    • type: "content_sha256"

      • "content_sha256"

    • content_sha256: optional string

      Expected content_sha256 of the stored memory (64 lowercase hexadecimal characters). Typically the content_sha256 returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.

Beta Managed Agents Deleted Memory

  • BetaManagedAgentsDeletedMemory object { id, type }

    Tombstone returned by Delete a memory. The memory's version history persists and remains listable via List memory versions until the store itself is deleted.

    • id: string

      ID of the deleted memory (a mem_... value).

    • type: "memory_deleted"

      • "memory_deleted"

Beta Managed Agents Error

  • BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more

    • BetaInvalidRequestError object { message, type }

      • message: string

      • type: "invalid_request_error"

        • "invalid_request_error"

    • BetaAuthenticationError object { message, type }

      • message: string

      • type: "authentication_error"

        • "authentication_error"

    • BetaBillingError object { message, type }

      • message: string

      • type: "billing_error"

        • "billing_error"

    • BetaPermissionError object { message, type }

      • message: string

      • type: "permission_error"

        • "permission_error"

    • BetaNotFoundError object { message, type }

      • message: string

      • type: "not_found_error"

        • "not_found_error"

    • BetaRateLimitError object { message, type }

      • message: string

      • type: "rate_limit_error"

        • "rate_limit_error"

    • BetaGatewayTimeoutError object { message, type }

      • message: string

      • type: "timeout_error"

        • "timeout_error"

    • BetaAPIError object { message, type }

      • message: string

      • type: "api_error"

        • "api_error"

    • BetaOverloadedError object { message, type }

      • message: string

      • type: "overloaded_error"

        • "overloaded_error"

    • BetaManagedAgentsMemoryPreconditionFailedError object { type, message }

      • type: "memory_precondition_failed_error"

        • "memory_precondition_failed_error"

      • message: optional string

    • BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }

      • type: "memory_path_conflict_error"

        • "memory_path_conflict_error"

      • conflicting_memory_id: optional string

      • conflicting_path: optional string

      • message: optional string

    • BetaManagedAgentsConflictError object { type, message }

      • type: "conflict_error"

        • "conflict_error"

      • message: optional string

Beta Managed Agents Memory

  • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

    A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

    • id: string

      Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

    • content_sha256: string

      Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

    • content_size_bytes: number

      Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_store_id: string

      ID of the memory store this memory belongs to (a memstore_... value).

    • memory_version_id: string

      ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

    • path: string

      Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

    • type: "memory"

      • "memory"

    • updated_at: string

      A timestamp in RFC 3339 format

    • content: optional string

      The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

Beta Managed Agents Memory List Item

  • BetaManagedAgentsMemoryListItem = BetaManagedAgentsMemory or BetaManagedAgentsMemoryPrefix

    One item in a List memories response: either a memory object or, when depth is set, a memory_prefix rollup marker.

    • BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }

      A memory object: a single text document at a hierarchical path inside a memory store. The content field is populated when view=full and null when view=basic; the content_size_bytes and content_sha256 fields are always populated so sync clients can diff without fetching content. Memories are addressed by their mem_... ID; the path is the create key and can be changed via update.

      • id: string

        Unique identifier for this memory (a mem_... value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

      • content_sha256: string

        Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

      • content_size_bytes: number

        Size of content in bytes (the UTF-8 plaintext length). Always populated, regardless of view.

      • created_at: string

        A timestamp in RFC 3339 format

      • memory_store_id: string

        ID of the memory store this memory belongs to (a memstore_... value).

      • memory_version_id: string

        ID of the memory_version representing this memory's current content (a memver_... value). This is the authoritative head pointer; memory_version objects do not carry an is_latest flag, so compare against this field instead. Enumerate the full history via List memory versions.

      • path: string

        Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

      • type: "memory"

        • "memory"

      • updated_at: string

        A timestamp in RFC 3339 format

      • content: optional string

        The memory's UTF-8 text content. Populated when view=full; null when view=basic. Maximum 100 kB (102,400 bytes).

    • BetaManagedAgentsMemoryPrefix object { path, type }

      A rolled-up directory marker returned by List memories when depth is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page limit and interleaves with memory items in path order.

      • path: string

        The rolled-up path prefix, including a trailing / (e.g. /projects/foo/). Pass this value as path_prefix on a subsequent list call to drill into the directory.

      • type: "memory_prefix"

        • "memory_prefix"

Beta Managed Agents Memory Path Conflict Error

  • BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }

    • type: "memory_path_conflict_error"

      • "memory_path_conflict_error"

    • conflicting_memory_id: optional string

    • conflicting_path: optional string

    • message: optional string

Beta Managed Agents Memory Precondition Failed Error

  • BetaManagedAgentsMemoryPreconditionFailedError object { type, message }

    • type: "memory_precondition_failed_error"

      • "memory_precondition_failed_error"

    • message: optional string

Beta Managed Agents Memory Prefix

  • BetaManagedAgentsMemoryPrefix object { path, type }

    A rolled-up directory marker returned by List memories when depth is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page limit and interleaves with memory items in path order.

    • path: string

      The rolled-up path prefix, including a trailing / (e.g. /projects/foo/). Pass this value as path_prefix on a subsequent list call to drill into the directory.

    • type: "memory_prefix"

      • "memory_prefix"

Beta Managed Agents Memory View

  • BetaManagedAgentsMemoryView = "basic" or "full"

    Selects which projection of a memory or memory_version the server returns. basic returns the object with content set to null; full populates content. When omitted, the default is endpoint-specific: retrieve operations default to full; list, create, and update operations default to basic. Listing with view=full caps limit at 20.

    • "basic"

    • "full"

Beta Managed Agents Precondition

  • BetaManagedAgentsPrecondition object { type, content_sha256 }

    Optimistic-concurrency precondition: the update applies only if the memory's stored content_sha256 equals the supplied value. On mismatch, the request returns memory_precondition_failed_error (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested content and path, the server returns 200 instead of 409.

    • type: "content_sha256"

      • "content_sha256"

    • content_sha256: optional string

      Expected content_sha256 of the stored memory (64 lowercase hexadecimal characters). Typically the content_sha256 returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes.

Memory Versions

List memory versions

get /v1/memory_stores/{memory_store_id}/memory_versions

List memory versions

Path Parameters

  • memory_store_id: string

Query Parameters

  • api_key_id: optional string

    Query parameter for api_key_id

  • "created_at[gte]": optional string

    Return versions created at or after this time (inclusive).

  • "created_at[lte]": optional string

    Return versions created at or before this time (inclusive).

  • limit: optional number

    Query parameter for limit

  • memory_id: optional string

    Query parameter for memory_id

  • operation: optional BetaManagedAgentsMemoryVersionOperation

    Query parameter for operation

    • "created"

    • "modified"

    • "deleted"

  • page: optional string

    Query parameter for page

  • session_id: optional string

    Query parameter for session_id

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • data: optional array of BetaManagedAgentsMemoryVersion

    One page of memory_version objects, ordered by created_at descending (newest first), with id as tiebreak.

    • id: string

      Unique identifier for this version (a memver_... value).

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_id: string

      ID of the memory this version snapshots (a mem_... value). Remains valid after the memory is deleted; pass it as memory_id to List memory versions to retrieve the full lineage including the deleted row.

    • memory_store_id: string

      ID of the memory store this version belongs to (a memstore_... value).

    • operation: BetaManagedAgentsMemoryVersionOperation

      The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

      • "created"

      • "modified"

      • "deleted"

    • type: "memory_version"

      • "memory_version"

    • content: optional string

      The memory's UTF-8 text content as of this version. null when view=basic, when operation is deleted, or when redacted_at is set.

    • content_sha256: optional string

      Lowercase hex SHA-256 digest of content as of this version (64 characters). null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • content_size_bytes: optional number

      Size of content in bytes as of this version. null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • created_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

      • BetaManagedAgentsSessionActor object { session_id, type }

        Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

        • session_id: string

          ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

        • type: "session_actor"

          • "session_actor"

      • BetaManagedAgentsAPIActor object { api_key_id, type }

        Attribution for a write made directly via the public API (outside of any session).

        • api_key_id: string

          ID of the API key that performed the write. This identifies the key, not the secret.

        • type: "api_actor"

          • "api_actor"

      • BetaManagedAgentsUserActor object { type, user_id }

        Attribution for a write made by a human user through the Anthropic Console.

        • type: "user_actor"

          • "user_actor"

        • user_id: string

          ID of the user who performed the write (a user_... value).

    • path: optional string

      The memory's path at the time of this write. null if and only if redacted_at is set.

    • redacted_at: optional string

      A timestamp in RFC 3339 format

    • redacted_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

  • next_page: optional string

    Opaque cursor for the next page (a page_... value), or null if there are no more results. Pass as page on the next request.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "memory_id": "memory_id",
      "memory_store_id": "memory_store_id",
      "operation": "created",
      "type": "memory_version",
      "content": "content",
      "content_sha256": "content_sha256",
      "content_size_bytes": 0,
      "created_by": {
        "session_id": "x",
        "type": "session_actor"
      },
      "path": "path",
      "redacted_at": "2019-12-27T18:11:19.117Z",
      "redacted_by": {
        "session_id": "x",
        "type": "session_actor"
      }
    }
  ],
  "next_page": "next_page"
}

Retrieve a memory version

get /v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}

Retrieve a memory version

Path Parameters

  • memory_store_id: string

  • memory_version_id: string

Query Parameters

  • view: optional BetaManagedAgentsMemoryView

    Query parameter for view

    • "basic"

    • "full"

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }

    A memory_version object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with content, path, content_size_bytes, and content_sha256 set to null; branch on redacted_at, not HTTP status.

    • id: string

      Unique identifier for this version (a memver_... value).

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_id: string

      ID of the memory this version snapshots (a mem_... value). Remains valid after the memory is deleted; pass it as memory_id to List memory versions to retrieve the full lineage including the deleted row.

    • memory_store_id: string

      ID of the memory store this version belongs to (a memstore_... value).

    • operation: BetaManagedAgentsMemoryVersionOperation

      The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

      • "created"

      • "modified"

      • "deleted"

    • type: "memory_version"

      • "memory_version"

    • content: optional string

      The memory's UTF-8 text content as of this version. null when view=basic, when operation is deleted, or when redacted_at is set.

    • content_sha256: optional string

      Lowercase hex SHA-256 digest of content as of this version (64 characters). null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • content_size_bytes: optional number

      Size of content in bytes as of this version. null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • created_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

      • BetaManagedAgentsSessionActor object { session_id, type }

        Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

        • session_id: string

          ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

        • type: "session_actor"

          • "session_actor"

      • BetaManagedAgentsAPIActor object { api_key_id, type }

        Attribution for a write made directly via the public API (outside of any session).

        • api_key_id: string

          ID of the API key that performed the write. This identifies the key, not the secret.

        • type: "api_actor"

          • "api_actor"

      • BetaManagedAgentsUserActor object { type, user_id }

        Attribution for a write made by a human user through the Anthropic Console.

        • type: "user_actor"

          • "user_actor"

        • user_id: string

          ID of the user who performed the write (a user_... value).

    • path: optional string

      The memory's path at the time of this write. null if and only if redacted_at is set.

    • redacted_at: optional string

      A timestamp in RFC 3339 format

    • redacted_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_id": "memory_id",
  "memory_store_id": "memory_store_id",
  "operation": "created",
  "type": "memory_version",
  "content": "content",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_by": {
    "session_id": "x",
    "type": "session_actor"
  },
  "path": "path",
  "redacted_at": "2019-12-27T18:11:19.117Z",
  "redacted_by": {
    "session_id": "x",
    "type": "session_actor"
  }
}

Redact a memory version

post /v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

Redact a memory version

Path Parameters

  • memory_store_id: string

  • memory_version_id: string

Header Parameters

  • "anthropic-beta": optional array of AnthropicBeta

    Optional header to specify the beta version(s) you want to use.

    • string

    • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

      • "cache-diagnosis-2026-04-07"

Returns

  • BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }

    A memory_version object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with content, path, content_size_bytes, and content_sha256 set to null; branch on redacted_at, not HTTP status.

    • id: string

      Unique identifier for this version (a memver_... value).

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_id: string

      ID of the memory this version snapshots (a mem_... value). Remains valid after the memory is deleted; pass it as memory_id to List memory versions to retrieve the full lineage including the deleted row.

    • memory_store_id: string

      ID of the memory store this version belongs to (a memstore_... value).

    • operation: BetaManagedAgentsMemoryVersionOperation

      The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

      • "created"

      • "modified"

      • "deleted"

    • type: "memory_version"

      • "memory_version"

    • content: optional string

      The memory's UTF-8 text content as of this version. null when view=basic, when operation is deleted, or when redacted_at is set.

    • content_sha256: optional string

      Lowercase hex SHA-256 digest of content as of this version (64 characters). null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • content_size_bytes: optional number

      Size of content in bytes as of this version. null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • created_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

      • BetaManagedAgentsSessionActor object { session_id, type }

        Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

        • session_id: string

          ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

        • type: "session_actor"

          • "session_actor"

      • BetaManagedAgentsAPIActor object { api_key_id, type }

        Attribution for a write made directly via the public API (outside of any session).

        • api_key_id: string

          ID of the API key that performed the write. This identifies the key, not the secret.

        • type: "api_actor"

          • "api_actor"

      • BetaManagedAgentsUserActor object { type, user_id }

        Attribution for a write made by a human user through the Anthropic Console.

        • type: "user_actor"

          • "user_actor"

        • user_id: string

          ID of the user who performed the write (a user_... value).

    • path: optional string

      The memory's path at the time of this write. null if and only if redacted_at is set.

    • redacted_at: optional string

      A timestamp in RFC 3339 format

    • redacted_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_id": "memory_id",
  "memory_store_id": "memory_store_id",
  "operation": "created",
  "type": "memory_version",
  "content": "content",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_by": {
    "session_id": "x",
    "type": "session_actor"
  },
  "path": "path",
  "redacted_at": "2019-12-27T18:11:19.117Z",
  "redacted_by": {
    "session_id": "x",
    "type": "session_actor"
  }
}

Domain Types

Beta Managed Agents Actor

  • BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor

    Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

    • BetaManagedAgentsSessionActor object { session_id, type }

      Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

      • session_id: string

        ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

      • type: "session_actor"

        • "session_actor"

    • BetaManagedAgentsAPIActor object { api_key_id, type }

      Attribution for a write made directly via the public API (outside of any session).

      • api_key_id: string

        ID of the API key that performed the write. This identifies the key, not the secret.

      • type: "api_actor"

        • "api_actor"

    • BetaManagedAgentsUserActor object { type, user_id }

      Attribution for a write made by a human user through the Anthropic Console.

      • type: "user_actor"

        • "user_actor"

      • user_id: string

        ID of the user who performed the write (a user_... value).

Beta Managed Agents API Actor

  • BetaManagedAgentsAPIActor object { api_key_id, type }

    Attribution for a write made directly via the public API (outside of any session).

    • api_key_id: string

      ID of the API key that performed the write. This identifies the key, not the secret.

    • type: "api_actor"

      • "api_actor"

Beta Managed Agents Memory Version

  • BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }

    A memory_version object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with content, path, content_size_bytes, and content_sha256 set to null; branch on redacted_at, not HTTP status.

    • id: string

      Unique identifier for this version (a memver_... value).

    • created_at: string

      A timestamp in RFC 3339 format

    • memory_id: string

      ID of the memory this version snapshots (a mem_... value). Remains valid after the memory is deleted; pass it as memory_id to List memory versions to retrieve the full lineage including the deleted row.

    • memory_store_id: string

      ID of the memory store this version belongs to (a memstore_... value).

    • operation: BetaManagedAgentsMemoryVersionOperation

      The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

      • "created"

      • "modified"

      • "deleted"

    • type: "memory_version"

      • "memory_version"

    • content: optional string

      The memory's UTF-8 text content as of this version. null when view=basic, when operation is deleted, or when redacted_at is set.

    • content_sha256: optional string

      Lowercase hex SHA-256 digest of content as of this version (64 characters). null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • content_size_bytes: optional number

      Size of content in bytes as of this version. null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

    • created_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

      • BetaManagedAgentsSessionActor object { session_id, type }

        Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

        • session_id: string

          ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

        • type: "session_actor"

          • "session_actor"

      • BetaManagedAgentsAPIActor object { api_key_id, type }

        Attribution for a write made directly via the public API (outside of any session).

        • api_key_id: string

          ID of the API key that performed the write. This identifies the key, not the secret.

        • type: "api_actor"

          • "api_actor"

      • BetaManagedAgentsUserActor object { type, user_id }

        Attribution for a write made by a human user through the Anthropic Console.

        • type: "user_actor"

          • "user_actor"

        • user_id: string

          ID of the user who performed the write (a user_... value).

    • path: optional string

      The memory's path at the time of this write. null if and only if redacted_at is set.

    • redacted_at: optional string

      A timestamp in RFC 3339 format

    • redacted_by: optional BetaManagedAgentsActor

      Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

Beta Managed Agents Memory Version Operation

  • BetaManagedAgentsMemoryVersionOperation = "created" or "modified" or "deleted"

    The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

    • "created"

    • "modified"

    • "deleted"

Beta Managed Agents Session Actor

  • BetaManagedAgentsSessionActor object { session_id, type }

    Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

    • session_id: string

      ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

    • type: "session_actor"

      • "session_actor"

Beta Managed Agents User Actor

  • BetaManagedAgentsUserActor object { type, user_id }

    Attribution for a write made by a human user through the Anthropic Console.

    • type: "user_actor"

      • "user_actor"

    • user_id: string

      ID of the user who performed the write (a user_... value).