Referência da API

Memory stores

Crie stores de memória e gerencie documentos versionados por path dentro de um projeto.

#Endpoints

Método	Caminho	Descrição
POST	`/v1/projects/:projectId/memory_stores`	Cria um memory store.
GET	`/v1/projects/:projectId/memory_stores`	Lista stores por cursor.
GET	`/v1/projects/:projectId/memory_stores/:storeId`	Lê metadados do store.
DELETE	`/v1/projects/:projectId/memory_stores/:storeId`	Remove o store.
PUT	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path`	Cria a próxima versão de um documento.
GET	`/v1/projects/:projectId/memory_stores/:storeId/memories`	Lista documentos do store.
GET	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path`	Lê a versão atual com conteúdo.
DELETE	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path`	Remove o documento.
GET	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path/versions`	Lista versões com `beforeVersion`.
GET	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path/versions/:version`	Lê uma versão específica.
POST	`/v1/projects/:projectId/memory_stores/:storeId/memories/*path/redact`	Redige o conteúdo legível.

#Criar store

bash

curl -sS -X POST "$NOORDEN_API_URL/v1/projects/$PROJECT_ID/memory_stores" \
  -H "Authorization: Bearer $NOORDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer context",
    "description": "Contexto aprovado por cliente"
  }'

#Escrever documento

Escrever no mesmo path cria uma nova versão.

bash

curl -sS -X PUT "$NOORDEN_API_URL/v1/projects/$PROJECT_ID/memory_stores/$STORE_ID/memories/clientes/cus_123/resumo.md" \
  -H "Authorization: Bearer $NOORDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Cliente prefere contato por WhatsApp e autorizou resumo para próximos atendimentos."
  }'

A resposta inclui metadados de versão, integridade e preview. Use esses campos para auditoria e UI, não para reconstruir conteúdo completo.

#Histórico de versões

http

GET /v1/projects/:projectId/memory_stores/:storeId/memories/:path/versions?beforeVersion=8&limit=20

beforeVersion pagina versões anteriores à versão informada. Omita o parâmetro para começar pela mais recente.

#Redação

Redação remove o conteúdo legível de um documento, mantendo metadados e histórico estrutural.

http

POST /v1/projects/:projectId/memory_stores/:storeId/memories/:path/redact