AgentMemory

View as Markdown

Get My Agent Delivered Memory

GET/api/v1/memory/my/agents/{agent_id}/delivered

Return the exact last-delivered MEMORY.md when it is wholly brand-owned.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/agents/{agent_id}/delivered" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Memory Deliveries

GET/api/v1/memory/memory-deliveries

Return delivery metadata to an authenticated dashboard operator.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/memory-deliveries" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Sources

GET/api/v1/memory/sources
Request
curl "https://app.opvs.ai/api/v1/memory/sources" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Create Source

POST/api/v1/memory/sources
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/sources" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Source

GET/api/v1/memory/sources/{source_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/sources/{source_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Source

PATCH/api/v1/memory/sources/{source_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PATCH "https://app.opvs.ai/api/v1/memory/sources/{source_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete Source

DELETE/api/v1/memory/sources/{source_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/memory/sources/{source_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Sync Source

POST/api/v1/memory/sources/{source_id}/sync

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/sources/{source_id}/sync" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Ingest Session Events

POST/api/v1/memory/ingest

Submit pre-redacted local session events for extraction.

Request
curl -X POST "https://app.opvs.ai/api/v1/memory/ingest" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Sync Knowledge

POST/api/v1/memory/knowledge:sync

Pin one repository knowledge snapshot to the caller's own code project.

Request
curl -X POST "https://app.opvs.ai/api/v1/memory/knowledge:sync" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List Sessions

GET/api/v1/memory/sessions
Request
curl "https://app.opvs.ai/api/v1/memory/sessions" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Session

GET/api/v1/memory/sessions/{session_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/sessions/{session_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Entries Near

POST/api/v1/memory/entries:near

Return live lessons, their guards, and paths near selected code nodes.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries:near" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Lookup Anchors

POST/api/v1/memory/anchors:lookup
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/anchors:lookup" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Similar Entries

POST/api/v1/memory/entries:similar
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries:similar" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Search Entries

GET/api/v1/memory/entries/search
Request
curl "https://app.opvs.ai/api/v1/memory/entries/search" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Export My Memories

GET/api/v1/memory/my/export

Download memories learned from this brand's own conversations.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/export" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Pending My Memory Reviews

GET/api/v1/memory/my/memories/review/pending

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/memories/review/pending" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List My Memory Verdicts

GET/api/v1/memory/my/memories/verdicts

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/memories/verdicts" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Approve My Memory Verdict

POST/api/v1/memory/my/memories/verdicts/{verdict_id}/approve

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/verdicts/{verdict_id}/approve" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Override My Memory Verdict

POST/api/v1/memory/my/memories/verdicts/{verdict_id}/override

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/verdicts/{verdict_id}/override" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Create My Memory Verdict

POST/api/v1/memory/my/memories/{memory_id}/verdicts

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/verdicts" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Query Desk Memories

GET/api/v1/memory/desks/{desk_ref}/memories

List memory under a brand-owned dev desk's stable environment identity.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/desks/{desk_ref}/memories" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Query My Memories

GET/api/v1/memory/my/memories

List memories learned in the selected brand's conversations.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/memories" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Pin My Memory

POST/api/v1/memory/my/memories/{memory_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Unpin My Memory

DELETE/api/v1/memory/my/memories/{memory_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN"

My Memory Pin History

GET/api/v1/memory/my/memories/{memory_id}/pins

The pin history of one memory, for a dashboard user.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/pins" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Forget My Memory

POST/api/v1/memory/my/memories/{memory_id}/forget

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/forget" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Restore My Memory

POST/api/v1/memory/my/memories/{memory_id}/restore

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/restore" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Correct My Memory

POST/api/v1/memory/my/memories/{memory_id}/correct

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/my/memories/{memory_id}/correct" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Query Memories

GET/api/v1/memory/memories
Request
curl "https://app.opvs.ai/api/v1/memory/memories" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Create Memory

POST/api/v1/memory/memories
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/memories" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Query Platform Memories

GET/api/v1/memory/platform/memories
Request
curl "https://app.opvs.ai/api/v1/memory/platform/memories" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Memory Stats

GET/api/v1/memory/memories/stats
Request
curl "https://app.opvs.ai/api/v1/memory/memories/stats" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Pin History

GET/api/v1/memory/pins

Return tenant-wide pin history to a super-admin dashboard session.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/pins" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Memory Pin History

GET/api/v1/memory/memories/{memory_id}/pins

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/memories/{memory_id}/pins" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Memory

GET/api/v1/memory/memories/{memory_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/memories/{memory_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Memory

PATCH/api/v1/memory/memories/{memory_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PATCH "https://app.opvs.ai/api/v1/memory/memories/{memory_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete Memory

DELETE/api/v1/memory/memories/{memory_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/memory/memories/{memory_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Pending Entries

GET/api/v1/memory/entries/pending
Request
curl "https://app.opvs.ai/api/v1/memory/entries/pending" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Entry Verdicts

GET/api/v1/memory/entries/verdicts

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/entries/verdicts" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Entry Verdict Stats

GET/api/v1/memory/entries/verdicts/stats

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/entries/verdicts/stats" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Entry Checks

GET/api/v1/memory/entries/checks

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/entries/checks" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Summarize Entry Checks

GET/api/v1/memory/entries/checks/summary
Request
curl "https://app.opvs.ai/api/v1/memory/entries/checks/summary" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Override Entry Verdict

POST/api/v1/memory/entries/verdicts/{verdict_id}/override

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries/verdicts/{verdict_id}/override" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Approve Entry Verdict

POST/api/v1/memory/entries/verdicts/{verdict_id}/approve

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries/verdicts/{verdict_id}/approve" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Create Entry Verdict

POST/api/v1/memory/entries/{entry_id}/verdicts

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries/{entry_id}/verdicts" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Pin Memory

POST/api/v1/memory/memories/{memory_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/memories/{memory_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Unpin Memory

DELETE/api/v1/memory/memories/{memory_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/memory/memories/{memory_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Pin Entry

POST/api/v1/memory/entries/{entry_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/entries/{entry_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Unpin Entry

DELETE/api/v1/memory/entries/{entry_id}/pin

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/memory/entries/{entry_id}/pin" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Entry Pin History

GET/api/v1/memory/entries/{entry_id}/pins

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/entries/{entry_id}/pins" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Entry Stats

GET/api/v1/memory/entries/stats
Request
curl "https://app.opvs.ai/api/v1/memory/entries/stats" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Entry

GET/api/v1/memory/entries/{entry_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/memory/entries/{entry_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Agent Context

POST/api/v1/memory/agents/{agent_id}/context

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/agents/{agent_id}/context" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Relevant Context

POST/api/v1/memory/agents/{agent_id}/context/relevant

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/agents/{agent_id}/context/relevant" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Extract On Disconnect

POST/api/v1/memory/agents/{agent_id}/extract-on-disconnect

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/agents/{agent_id}/extract-on-disconnect" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Trigger Extraction

POST/api/v1/memory/pipeline/extract/{source_id}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/pipeline/extract/{source_id}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List Runs

GET/api/v1/memory/pipeline/runs
Request
curl "https://app.opvs.ai/api/v1/memory/pipeline/runs" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Trigger Maintenance

POST/api/v1/memory/pipeline/maintain
Request
curl -X POST "https://app.opvs.ai/api/v1/memory/pipeline/maintain" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List Maintenance Runs

GET/api/v1/memory/pipeline/maintenance-runs
Request
curl "https://app.opvs.ai/api/v1/memory/pipeline/maintenance-runs" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Memory Sharing

GET/api/v1/brands/{brand_id}/memory-sharing

Read this brand's sharing choice; any active member may call it.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/brands/{brand_id}/memory-sharing" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Put Memory Sharing

PUT/api/v1/brands/{brand_id}/memory-sharing

Create or update this brand's sharing choice; brand admins only.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/brands/{brand_id}/memory-sharing" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Did this answer your question?