v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB

Memories

Set a memory

Create or update a durable JSON memory under an org or function scope. Function-authenticated requests use their own Function id and cannot override it. If no explicit scope is provided for other credentials, x-primitive-function-id is used next, and other requests default to org scope. Function scope uses the function id UUID, not the function name.

put/memories

Headers

x-primitive-function-idstring uuid

Optional function id UUID used as the default scope for non-function-authenticated requests when the body does not include scope. Ignored when scope is provided.

Request body

keystring required

Caller-defined key, at most 512 UTF-8 bytes.

ttl_secondsinteger

Set or replace the TTL in seconds. Mutually exclusive with expires_at and clear_ttl.

expires_atstring date-time

Set or replace the absolute expiration timestamp. Mutually exclusive with ttl_seconds and clear_ttl.

clear_ttlboolean

Clear any existing TTL. Mutually exclusive with ttl_seconds and expires_at.

if_absentboolean

Create only when the key is absent. Mutually exclusive with if_version.

if_versionstring

Bigint counter serialized as a base-10 string.

Response

Existing memory updated.

successtrue required