API Reference.

27 REST endpoints. JSON request and response bodies. All endpoints require authentication via API key header or cloud user session.

BASE URL

https://api.memosift.com

AUTHENTICATION

Authorization: Bearer msk_...

7 groups

POST/v1/ingest202 AcceptedAPI Key

Receive a complete turn payload from the SDK. Classifies content, extracts memories and entities, stores artifacts, and runs security scans.

Request

{
  "session_id": "my-session",
  "turn_number": 1,
  "user_message": {
    "role": "user",
    "content": "Read the auth module"
  },
  "assistant_reply": {
    "role": "assistant",
    "content": "Here's the code..."
  },
  "small_tool_results": [
    {
      "tool_name": "bash",
      "content": "exit 0"
    }
  ],
  "artifact_refs": [
    {
      "id": "art_7f2a",
      "type": "code_python",
      "format": "code_python",
      "content_sha256": "abc...",
      "tool_name": "read_file"
    }
  ],
  "security_findings": [
    {
      "finding_type": "pii_email",
      "matched_text": "john@acme.com",
      "start": 42,
      "end": 56,
      "confidence": 0.95
    }
  ]
}

Response

{
  "status": "accepted",
  "session_id": "my-session",
  "turn_number": 1,
  "artifacts_pending_upload": [
    "art_7f2a"
  ]
}