Mengram System API

Health, stats, and account management

GitHub OpenAPI

Operations 22

GET /api/playground/search Playground Search #
POST /api/playground/extract Playground Extract #
GET /v1/me Me #
POST /v1/signup Signup #
POST /v1/verify Verify Signup #
POST /v1/reset-key Reset Key #
POST /v1/reset-key/verify Verify Reset Key #
GET /auth/github Github Login #
GET /auth/github/callback Github Callback #
GET /v1/keys List Keys #
POST /v1/keys Create Key #
DELETE /v1/keys/{key_id} Revoke Key #
PATCH /v1/keys/{key_id} Rename Key #
GET /v1/health Health #
GET /v1/jobs/{job_id} Job Status #
GET /v1/capture-policy Get Capture Policy #
PUT /v1/capture-policy Set Capture Policy #
DELETE /v1/account Delete Account #
GET /v1/stats Stats #
GET /v1/stats/weekly Stats Weekly #
GET /v1/intelligence Intelligence #
GET /v1/health/retrieval Get Retrieval Health #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mengram-io:mengram-io-system-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mengram-io-system-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mengram System API
  description: '## Human-Like Memory for AI — Semantic + Episodic + Procedural


    The only AI memory API with 3 memory types. Your AI remembers facts, events, and learned workflows.


    ### 3 Memory Types

    - **Semantic** — facts, preferences, skills (entities, relations, knowledge graph)

    - **Episodic** — events, decisions, experiences (what happened, when, outcome)

    - **Procedural** — workflows, processes, habits (learned step-by-step procedures)


    ### Key Features

    - **Cognitive Profile** — one API call generates a system prompt from all memory types

    - **Unified Search** — search across all 3 types simultaneously

    - **Procedure Feedback** — AI learns which workflows succeed

    - **Memory Agents** — autonomous cleanup, pattern detection, weekly digests

    - **Team Sharing** — shared memory across team members

    - **LangChain** — drop-in replacement for ConversationBufferMemory

    - **CrewAI** — 5 tools with procedural learning (agents learn optimal workflows)

    - **OpenClaw** — plugin with auto-recall/capture hooks, 12 tools, and Graph RAG across all channels


    ### Authentication

    All endpoints require `Authorization: Bearer YOUR_API_KEY` header.


    ### Quick Start

    ```python

    from mengram import Mengram

    m = Mengram(api_key="om-...")

    m.add([{"role": "user", "content": "I use Python and Railway"}])

    results = m.search_all("deployment") # semantic + episodic + procedural

    profile = m.get_profile() # instant system prompt

    ```'
  version: 2.49.0
tags:
- name: System
  description: Health, stats, and account management
paths:
  /api/playground/search:
    get:
      tags:
      - System
      summary: Playground Search
      description: Public playground search — no auth required. Searches demo account only.
      operationId: playground_search_api_playground_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 200
          title: Q
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/playground/extract:
    post:
      tags:
      - System
      summary: Playground Extract
      description: Public playground extraction — no auth required. Extracts memory from text without saving.
      operationId: playground_extract_api_playground_extract_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/me:
    get:
      tags:
      - System
      summary: Me
      description: Current account info.
      operationId: me_v1_me_get
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/signup:
    post:
      tags:
      - System
      summary: Signup
      description: 'Step 1: Send verification code to email.'
      operationId: signup_v1_signup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/verify:
    post:
      tags:
      - System
      summary: Verify Signup
      description: 'Step 2: Verify code, create account, return API key.'
      operationId: verify_signup_v1_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignupResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/reset-key:
    post:
      tags:
      - System
      summary: Reset Key
      description: 'Step 1: Send verification code to reset API key.'
      operationId: reset_key_v1_reset_key_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResetKeyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/reset-key/verify:
    post:
      tags:
      - System
      summary: Verify Reset Key
      description: 'Step 2: Verify code and get new API key.'
      operationId: verify_reset_key_v1_reset_key_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignupResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/github:
    get:
      tags:
      - System
      summary: Github Login
      description: Redirect to GitHub OAuth authorization page.
      operationId: github_login_auth_github_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /auth/github/callback:
    get:
      tags:
      - System
      summary: Github Callback
      description: Handle GitHub OAuth callback — create/login user and show API key.
      operationId: github_callback_auth_github_callback_get
      parameters:
      - name: code
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Code
      - name: state
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: State
      - name: error
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Error
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/keys:
    get:
      tags:
      - System
      summary: List Keys
      description: List all API keys for your account.
      operationId: list_keys_v1_keys_get
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - System
      summary: Create Key
      description: Create a new API key with a name.
      operationId: create_key_v1_keys_post
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              title: Req
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/keys/{key_id}:
    delete:
      tags:
      - System
      summary: Revoke Key
      description: Revoke a specific API key.
      operationId: revoke_key_v1_keys__key_id__delete
      parameters:
      - name: key_id
        in: path
        required: true
        schema:
          type: string
          title: Key Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - System
      summary: Rename Key
      description: Rename an API key.
      operationId: rename_key_v1_keys__key_id__patch
      parameters:
      - name: key_id
        in: path
        required: true
        schema:
          type: string
          title: Key Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              title: Req
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/health:
    get:
      tags:
      - System
      summary: Health
      description: Health check. Returns basic status for unauthenticated, detailed diagnostics for authenticated.
      operationId: health_v1_health_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/jobs/{job_id}:
    get:
      tags:
      - System
      summary: Job Status
      description: Check status of a background job.
      operationId: job_status_v1_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/capture-policy:
    get:
      tags:
      - System
      summary: Get Capture Policy
      description: 'Get the account''s capture boundary — what extraction is allowed to

        persist. Empty = capture everything (default). Deterministic,

        server-side: category packs + custom keywords + source rules.'
      operationId: get_capture_policy_v1_capture_policy_get
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - System
      summary: Set Capture Policy
      description: 'Set the capture boundary. Applied deterministically before any

        extracted memory is persisted — facts, episodes, and procedures

        matching a deny rule are dropped, never written. Enforced server-side,

        not a prompt asking the model to behave.'
      operationId: set_capture_policy_v1_capture_policy_put
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CapturePolicyRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/account:
    delete:
      tags:
      - System
      summary: Delete Account
      description: 'Permanently delete this account and ALL associated data (memories,

        episodes, procedures, chunks, webhooks, teams you created, API keys,

        usage history). Irreversible. Requires confirm=.

        An active paid subscription is canceled in Paddle first — if that

        cancellation fails, deletion aborts so you don''t keep being billed.'
      operationId: delete_account_v1_account_delete
      parameters:
      - name: confirm
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Confirm
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stats:
    get:
      tags:
      - System
      summary: Stats
      description: Usage statistics.
      operationId: stats_v1_stats_get
      parameters:
      - name: sub_user_id
        in: query
        required: false
        schema:
          type: string
          default: default
          title: Sub User Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stats/weekly:
    get:
      tags:
      - System
      summary: Stats Weekly
      description: 'Weekly memory report: facts/procedures learned, recalls served,

        repeated-mistake preventions.'
      operationId: stats_weekly_v1_stats_weekly_get
      parameters:
      - name: sub_user_id
        in: query
        required: false
        schema:
          type: string
          default: default
          title: Sub User Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/intelligence:
    get:
      tags:
      - System
      summary: Intelligence
      description: Intelligence dashboard — compound learning metrics.
      operationId: intelligence_v1_intelligence_get
      parameters:
      - name: sub_user_id
        in: query
        required: false
        schema:
          type: string
          default: default
          title: Sub User Id
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/health/retrieval:
    get:
      tags:
      - System
      summary: Get Retrieval Health
      description: 'Memory Health Monitor — per-user retrieval quality snapshot.


        Aggregated every 6h from the trailing 24h window of scored searches.

        Helps detect silent quality drops (every search returns 200, but

        relevance is degrading). See blog post on Memory Health Monitor

        for the rationale.


        Returns 404 if user has fewer than 5 scored searches in the window

        (insufficient signal — no snapshot computed yet).'
      operationId: get_retrieval_health_v1_health_retrieval_get
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CapturePolicyRequest:
      properties:
        deny_categories:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Deny Categories
        deny_keywords:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Deny Keywords
        deny_sources:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Deny Sources
        allow_sources:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Allow Sources
      type: object
      title: CapturePolicyRequest
    ResetKeyRequest:
      properties:
        email:
          type: string
          title: Email
      type: object
      required:
      - email
      title: ResetKeyRequest
    SignupRequest:
      properties:
        email:
          type: string
          title: Email
        website:
          type: string
          title: Website
          default: ''
        source:
          type: string
          title: Source
          default: ''
      type: object
      required:
      - email
      title: SignupRequest
    VerifyRequest:
      properties:
        email:
          type: string
          title: Email
        code:
          type: string
          title: Code
        source:
          type: string
          title: Source
          default: ''
      type: object
      required:
      - email
      - code
      title: VerifyRequest
    SignupResponse:
      properties:
        api_key:
          type: string
          title: Api Key
        message:
          type: string
          title: Message
      type: object
      required:
      - api_key
      - message
      title: SignupResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError