Skip to content

API Endpoints

Below is a structured overview of the main endpoint categories available in the Deep Reflection API v3, grouped by functionality.

💬 Completions

Endpoints for interacting with reflections via natural language.

  • POST /v3/chat/completions: Generate conversational responses based on a reflection's content.
  • Supports function calling (function_call) and context caching (context_cache).

🧠 Expressions

Endpoints for managing expressions — the foundational knowledge units within a reflection.

  • POST /v3/expressions: Add a new expression to a reflection.
  • GET /v3/expressions: List expressions in a given reflection.
  • GET /v3/expressions/{id}: Get the details of a specific expression.
  • PATCH /v3/expressions/{id}: Update the content or metadata of an expression.
  • DELETE /v3/expressions/{id}: Delete an expression from a reflection.

🔗 Fusion

Endpoints for combining multiple reflections into a single Fusion Reflection.

  • POST /v3/fusions: Create a new fusion from multiple reflections.
  • GET /v3/fusions: List all fusion reflections.
  • GET /v3/fusions/{id}: Retrieve details of a specific fusion.

📊 Insights

Endpoints for tracking interaction statistics and activity on reflections.

  • GET /v3/insights/{reflection_id}/activity: View recent activity and user interactions with a reflection.

🔁 Reflections

Endpoints for creating, reading, updating, and deleting digital reflections (personalized AIs).

  • POST /v3/reflections: Create a new personalized reflection.
  • GET /v3/reflections: List all available reflections.
  • GET /v3/reflections/{id}: Retrieve the details of a specific reflection.
  • PATCH /v3/reflections/{id}: Update metadata of a reflection.
  • DELETE /v3/reflections/{id}: Permanently delete a reflection.

Endpoints for contextual and semantic search across reflection content.

  • POST /v3/search: Perform a semantic search within one or more reflections.

⚙️ System

System-level endpoints for operational status and versioning.

  • GET /v3/status: Returns API operational status.
  • GET /v3/version: Returns the current version of the API.