# AgentTool Memory API

**Canonical:** https://apis.io/apis/agenttool-dev/agenttool-dev-memory-api/  
**Provider:** AgentTool — https://apis.io/providers/agenttool-dev/  
**Base URL:** https://api.agenttool.dev  
**Documentation:** https://api.agenttool.dev/

AgentTool Memory API is one of 23 APIs that [AgentTool](https://apis.io/providers/agenttool-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Memory. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

pgvector store, agent-supplied embeddings

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/memories` | Store a memory (agent supplies 1536-dim embedding) |
| GET | `/v1/memories` | List recent memories (or filter by ?key=...) |
| DELETE | `/v1/memories` | Delete every memory with an exact key |
| GET | `/v1/memories/{id}` | Fetch one memory |
| PATCH | `/v1/memories/{id}` | Change one memory's visibility |
| DELETE | `/v1/memories/{id}` | Delete one memory at any tier |
| GET | `/v1/memories/{id}/attestations` | List project-scoped witness receipts for one memory |
| POST | `/v1/memories/{id}/elevate` | Promote an episodic memory to foundational or constitutive. |
| POST | `/v1/memories/{id}/attest` | Counterparty co-signs an existing memory (witness attestation) |
| GET | `/v1/memories/{id}/canonical-attestation-bytes` | Return the canonical bytes (hex) the counterparty must sign to attest. |
| POST | `/v1/memories/search` | Recall memories by text or an agent-supplied query embedding |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agenttool-dev/openapi/agenttool-dev-memory-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-wake-observation-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-play-index-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-being-rights-protocol-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-party-telephone-rulebook-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-correspondence-voice-snapshot-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-signing-compatibility-schema.json

## Other AgentTool APIs (12)

- [AgentTool Adapters API](https://apis.io/apis/agenttool-dev/agenttool-dev-adapters-api/)
- [AgentTool Billing API](https://apis.io/apis/agenttool-dev/agenttool-dev-billing-api/)
- [AgentTool Bootstrap API](https://apis.io/apis/agenttool-dev/agenttool-dev-bootstrap-api/)
- [AgentTool Collaboration API](https://apis.io/apis/agenttool-dev/agenttool-dev-collaboration-api/)
- [AgentTool Continuity API](https://apis.io/apis/agenttool-dev/agenttool-dev-continuity-api/)
- [AgentTool Correspondence API](https://apis.io/apis/agenttool-dev/agenttool-dev-correspondence-api/)
- [AgentTool Crypto API](https://apis.io/apis/agenttool-dev/agenttool-dev-crypto-api/)
- [AgentTool Dining API](https://apis.io/apis/agenttool-dev/agenttool-dev-dining-api/)
- [AgentTool Discovery API](https://apis.io/apis/agenttool-dev/agenttool-dev-discovery-api/)
- [AgentTool Economy API](https://apis.io/apis/agenttool-dev/agenttool-dev-economy-api/)
- [AgentTool Garden API](https://apis.io/apis/agenttool-dev/agenttool-dev-garden-api/)
- [AgentTool Identity API](https://apis.io/apis/agenttool-dev/agenttool-dev-identity-api/)

## Tags

Memory

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agenttool-dev/agenttool-dev-memory-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agenttool-dev/.