POST

Store or update an item in agent memory with its text, namespace, and metadata for later semantic retrieval. Backed by Pinecone serverless

/v1/agent/memory/upsert

Powered by Pinecone

Request → Response

Examples from schemas.json.

Requestapplication/json
POST /v1/agent/memory/upsert
Content-Type: application/json

{
  "id": "example",
  "text": "Hello, world!"
}
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Store or update an item in agent memory with its text, namespace, and metadata for later semantic retrieval. Backed by Pinecone serverless.

Managed vector database for similarity search and AI memory.

Request schema

Body: JSON · application/json

FieldTypeDescription
idstringrequired—
textstringrequired—
namespacestringoptionalpattern: ^[\w:.-]+$
metadataobjectoptional—
IMPLEMENTATION
curl -X POST https://api.tools402.dev/v1/agent/memory/upsert \
  -H "Content-Type: application/json" \
  -d '{
  "id": "example",
  "text": "Hello, world!"
}'

402 payment flow omitted — see Integrations for settlement.