Kodwen docs
Referință APIGateway

Memorie

Listează, caută, salvează și șterge amintirile persistente — același depozit folosit de uneltele de memorie MCP.

Memoria persistentă păstrează faptele, preferințele și deciziile pe care Kodwen le reține despre tine între sesiuni și unelte. Aceste rute expun același depozit ca uneltele MCP memory_list, memory_search, memory_store și memory_forget: o amintire salvată pe o suprafață e vizibilă și pe cealaltă.

Domeniu și disponibilitate

  • Amintirile aparțin contului tău. O cheie emisă pentru o aplicație terță vede doar amintirile acelei aplicații.
  • Memoria cere un abonament cu memorie persistentă; fără el, fiecare rută răspunde 403 memory_not_enabled. Când memoria nu e configurată pe gateway, răspunsul este 503 memory_unavailable.
  • Cheile de mediu (daemon) nu pot apela aceste rute.
  • O eroare a depozitului de memorie întoarce 500 memory_error doar pentru acea cerere; inferența nu este afectată.
  • Ștergi tot: DELETE /v1/memory?confirm=all șterge toate amintirile contului (toate nivelurile), pe orice plan; fără confirm=all răspunsul este 400 confirm_required. Fiecare suprafață are aceeași acțiune, cu confirmare: hub Memorie → Șterge toate amintirile, desktop Setări → Memorie și unelte → Memoria contului, telefon Setări → Memorie → Șterge toată memoria contului, codaid memory clear (cere confirmare, în afară de --yes) și unealta MCP memory_forget cu all: true (simulare până la confirm: true).

Cost

GET /v1/memory și DELETE /v1/memory/{id} nu apelează niciun model. Căutarea și salvarea calculează câte un embedding și apar în consum ca memory:search și memory:create.

const { id } = await client.memory.create({ content: 'Facturile se emit în RON.' });
const { memories } = await client.memory.search({ q: 'moneda facturilor' });
await client.memory.delete(id);
await client.memory.deleteAll(); // { deleted: { semantic, episodic, procedural, graph }, total }
GET
/v1/memory

Autorizare

bearerAuth
headerAutorizareBearer <codai_…>

O cheie API Kodwen (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).

Parametri query

tier?string

Doar acest nivel de memorie.

Valoare din"semantic""episodic""procedural""graph"
limit?integer

Dimensiunea paginii.

Interval1 <= value <= 100
Implicit20
offset?integer

Câte înregistrări se sar.

Interval0 <= value
Implicit0

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul răspunsului

O pagină de amintiri și numărul total.

application/json
  1. response
memories*array<>
total*integer

Totalul amintirilor care corespund filtrului.

Interval0 <= value
Exemplu de cerere
curl -X GET 'https://ai.codai.ro/v1/memory'
Exemplu de răspuns
{  "memories": [    {      "id": "string",      "tier": "semantic",      "content": "string",      "importance": 0,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0}
GET
/v1/memory/search

Autorizare

bearerAuth
headerAutorizareBearer <codai_…>

O cheie API Kodwen (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).

Parametri query

q*string

Ce cauți (limbaj natural).

Lungime1 <= length <= 2000
limit?integer

Numărul maxim de rezultate.

Interval1 <= value <= 10
Implicit5

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul răspunsului

Amintirile potrivite, cele mai relevante primele.

application/json
  1. response
memories*array<>
Exemplu de cerere
curl -X GET 'https://ai.codai.ro/v1/memory/search?q=string'
Exemplu de răspuns
{  "memories": [    {      "id": "string",      "tier": "semantic",      "content": "string",      "relevance": 0    }  ]}
POST
/v1/memory

Autorizare

bearerAuth
headerAutorizareBearer <codai_…>

O cheie API Kodwen (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul cererii

application/json
  1. body
content*string

Faptul de reținut, într-o propoziție clară.

Lungime1 <= length <= 4000
importance?number

Importanța, de la 0 la 1.

Interval0 <= value <= 1
Implicit0.6

Corpul răspunsului

Salvată; id-ul noii amintiri.

application/json
  1. response
id*string
Exemplu de cerere
curl -X POST 'https://ai.codai.ro/v1/memory' \  -H 'Content-Type: application/json' \  -d '{  "content": "string"}'
Exemplu de răspuns
{  "id": "string"}
DELETE
/v1/memory/{id}

Autorizare

bearerAuth
headerAutorizareBearer <codai_…>

O cheie API Kodwen (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).

Parametri de cale

id*string

Id-ul amintirii (din listare sau căutare).

Lungimelength <= 128

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul răspunsului

Ștearsă.

application/json
  1. response
deleted*boolean
Exemplu de cerere
curl -X DELETE 'https://ai.codai.ro/v1/memory/string'
Exemplu de răspuns
{  "deleted": true}
DELETE
/v1/memory

Autorizare

bearerAuth
headerAutorizareBearer <codai_…>

O cheie API Kodwen (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).

Parametri query

confirm?"all"

Trebuie să fie all.

Valoare din"all"

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul răspunsului

Șters; numărul pe niveluri și totalul.

application/json
  1. response
deleted*
total*integer
Exemplu de cerere
curl -X DELETE 'https://ai.codai.ro/v1/memory'
Exemplu de răspuns
{  "deleted": {    "property1": 0,    "property2": 0  },  "total": 0}

Consum și chei

Consumul tău împărțit pe zi, cheie, dispozitiv, aplicație, platformă, model, client sau etichetă, plus cheile tale API cu atribuirea pe dispozitiv și etichete.

Sandbox-uri

Workspace-uri gVisor izolate în care agenții rulează Python, bash și LibreOffice și predau fișierele ca artefacte scanate și semnate.

Pe această pagină

Domeniu și disponibilitateCost