oracle / oracle/ai-optimizer

Memory 4: REST API

Open
#563 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
101
Forks
46
Avg merge
6h 19m
Merged PRs (30d)
23

Description

Add an authenticated /v1/memory router using the existing src/server/app/api/v1/router.py pattern.

Proposed surface:

  • POST /v1/memory/threads
  • GET /v1/memory/threads/{thread_id}/messages
  • POST /v1/memory/threads/{thread_id}/messages
  • DELETE /v1/memory/threads/{thread_id}
  • POST /v1/memory/search
  • POST /v1/memory/memories
  • PATCH /v1/memory/memories/{memory_id}
  • DELETE /v1/memory/memories/{memory_id}
  • GET /v1/memory/threads/{thread_id}/context-card

Use POST for search because metadata filters can be structured and should not be placed in query strings or access logs.

Important deletion semantics:

  • "New conversation" should rotate to a new thread.
  • delete_thread is a separate destructive operation because the SDK cascades through messages, derived memories, and retrieval data.
  • Deleting an individual message does not necessarily remove memories previously derived from it.

Reference: Oracle Agent Memory thread API.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading src/server/app/api/v1/router.py to follow the existing router pattern, then compare the proposed routes with the Oracle Agent Memory thread API reference. Done means the authenticated /v1/memory surface exists with the listed thread, message, search, memory, and context-card operations, including the stated deletion semantics.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.