memory

Apply one explicit factual-memory evolution operation

Applies ADD, UPDATE, DELETE, or NOOP through the atomic public SDK state machine. The project key fixes org/project scope and user_id fixes the end-user partition. Service and evaluation keys are denied.

post/v1/evolve

Request

Base URL: https://api.contextdb.ai
URL: https://api.contextdb.ai/v1/evolve
Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable project-scoped key for this logical mutation or job. Retrying with the same key and payload resolves to the original resource or response; reuse with a different payload returns 409.

Request body

user_idstring required

End-user memory partition key. Not an identity assertion.

operation'add' | 'update' | 'delete' | 'noop' required

contentstring

source'user_stated' | 'agent_inferred' | 'third_party'

Who vouches for the claim. Required on writes.

confidencenumber

action_relevantboolean

entitystring

attributestring

target_memory_idstring

metadataobject

noop_reasonstring

Response

Applied operation and resulting consistency floor

requested_operation'add' | 'update' | 'delete' | 'noop' required

applied_operation'add' | 'update' | 'delete' | 'noop' required

outcome'added' | 'updated' | 'deleted' | 'noop' | 'contested' required

previous_memory_idsstring[] required

deleted_memory_idsstring[] required

noop_reasonstring nullable required

memory_versioninteger required

Monotonic consistency version within one organization/project.

primary_wal_lsnstring nullable required

Primary PostgreSQL WAL position observed after commit.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.