Memory Stores

Get an update result

GET /memory_stores/{name}/updates/{update_id}

Retrieves the status and result of a memory store update operation.

Header parameters

Foundry-Features enum required

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

MemoryStores=V1Preview

Path parameters

name string required

The name of the memory store.

update_id string required

The ID of the memory update operation.

Query parameters

api-version string required

The API version to use for this operation.

Responses

The request has succeeded.

Body

Content-Type: application/json

update_id string required

The unique ID of this update request. Use this value as previous_update_id in subsequent requests to perform incremental updates.

status string | enum required

Status of a memory store update operation.

Any of the following:

string

enum

queuedin_progresscompletedfailedsuperseded

superseded_by string

The update_id the operation was superseded by when status is "superseded".

result MemoryStoreUpdateCompletedResult

Memory update result.

memory_operations MemoryOperation[] required

A list of individual memory operations that were performed during the update.

usage MemoryStoreOperationUsage required

Usage statistics of a memory store operation.

embedding_tokens integer required

The number of embedding tokens.

input_tokens integer required

input_tokens_details OpenAI.ResponseUsageInputTokensDetails required

cached_tokens integer required

cache_write_tokens integer required

output_tokens integer required

output_tokens_details OpenAI.ResponseUsageOutputTokensDetails required

reasoning_tokens integer required

total_tokens integer required

error OpenAI.Error

code string | null required

message string required

param string | null

type string

misalignment OpenAI.MisalignmentErrorDetailsResource

review_target string | null

error_type string | enum

Any of the following:

string

enum

potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother

detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer

message string required

The public continuation instruction.

details OpenAI.Error[]

additionalInfo object

debugInfo object