Pular para o conteúdo principal
PUT
Grava um valor
Cria a chave ou substitui o valor dela. A resposta é 201 quando a chave é nova e 200 quando o valor foi substituído, sempre com o registro gravado. Envie o valor em value. Ele pode ser qualquer JSON: um objeto, uma lista, um texto, um número, true ou false. Só não pode ser null; para apagar, use Apaga um valor.

Chaves

A chave usa letras minúsculas, números, -, _, . e barras entre as partes, com até 200 caracteres. A barra pode ir no endereço como está ou codificada como %2F. Grave cada ferramenta do seu site sob um prefixo próprio, como juros/simulacoes/... ou treino/diario/..., para uma não sobrescrever os dados da outra. Para criar um registro novo sem escolher um nome, gere um identificador no navegador, como treino/diario/${crypto.randomUUID()}.

Limites

Passar de um limite responde 422 com o código validation_failed. O motivo vem em errors: Apague o que a ferramenta não usa mais, como rascunhos antigos, para o membro não chegar ao limite.
O membro consegue alterar os próprios dados com o token dele. Nunca use o KV para decidir algo que vale alguma coisa, como pontos, liberação de aulas ou certificados.
Peso, medidas e outros dados de saúde são dados pessoais sensíveis pela LGPD. Guarde só o que a ferramenta precisa.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-Memberkit-Headless-Key
string
header
obrigatório

Chave headless da área de membros, em Configurações. É pública e vai em todas as requisições, inclusive nas que levam o token do membro.

Cabeçalhos

Idempotency-Key
string

Chave única do envio, para que uma repetição não seja duplicada.

Maximum string length: 255

Parâmetros de caminho

key
string
obrigatório

Chave com letras minúsculas, números, hífen, ponto, sublinhado e barras entre partes, como treino/diario/2026-10-28.

Maximum string length: 200

Corpo

application/json
value
any
obrigatório

Qualquer valor JSON, exceto null, com até 16 KB.

Resposta

Valor substituído

key
string
obrigatório
value
any
obrigatório

O valor JSON gravado pelo seu app.

updated_at
string<date-time>
obrigatório