> ## Documentation Index
> Fetch the complete documentation index at: https://docs.negentro.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Memories

> Store new information, agent interactions, and bitemporal facts into persistent memory.

`POST /api/v1/memories`

```bash POST /api/v1/memories theme={null}
curl -X POST https://api.piyapi.cloud/api/v1/memories \
  -H "Authorization: Bearer $PIYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Client requested SOC2 Type II compliance audit report for Q3 2026.",
    "tags": ["compliance", "soc2", "audit"],
    "metadata": { "client_id": "cli_8812", "urgency": "high" },
    "valid_at": "2026-08-01T00:00:00.000Z"
  }'
```

```json JSON theme={null}
{
  "memory": {
    "id": "8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "content": "Client requested SOC2 Type II compliance audit report for Q3 2026.",
    "namespace": "default",
    "tags": ["compliance", "soc2", "audit"],
    "created_at": "2026-08-03T15:10:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.