BrainstormRouter

BrainstormRouter Memory API

The memory API from BrainstormRouter — 23 operation(s) for memory.

GitHub OpenAPI

Operations 28

GET /auth/memory/blocks List per-block memory stats for the caller's tenant #
GET /auth/memory/entries List all core memory entries for the caller's tenant #
POST /auth/memory/entries Create a core memory entry #
DELETE /auth/memory/entries/{id} Delete a core memory entry #
PUT /auth/memory/entries/{id} Update a core memory entry (fact text and/or pin status) #
GET /auth/memory/pending List pending memory-write approvals #
POST /auth/memory/pending/{id}/approve Approve a pending memory write (commits to shared memory) #
POST /auth/memory/pending/{id}/reject Reject a pending memory write #
POST /auth/memory/query Score-rank core memory entries against a query string #
GET /auth/memory/shared/entries List shared-memory entries (tenant-wide) #
POST /auth/memory/shared/store Store a shared-memory entry (may enqueue for approval) #
GET /v1/memory/approval-config Get the memory-write approval-required flag #
PUT /v1/memory/approval-config Set the memory-write approval-required flag #
GET /v1/memory/blocks List memory blocks with entry counts (optional ?project= filter) #
POST /v1/memory/blocks/sync Bulk upsert core memory entries for a project (Brainstorm CLI) #
GET /v1/memory/blocks/{block} List entries in a specific memory block #
GET /v1/memory/entries List all core memory entries (optional ?project= filter) #
POST /v1/memory/entries Append a new core memory entry (alias for /v1/memory/store) #
DELETE /v1/memory/entries/{id} Delete a memory entry #
PUT /v1/memory/entries/{id} Update fact text and/or pin state for an entry #
POST /v1/memory/init Bootstrap memory from context documents via LLM extraction #
GET /v1/memory/pending List pending memory writes (unified queue + legacy) #
POST /v1/memory/pending/{id}/approve Approve a pending memory write (unified queue or legacy) #
POST /v1/memory/pending/{id}/reject Reject a pending memory write #
POST /v1/memory/query Relevance-scored memory query (top-N matches) #
GET /v1/memory/shared/entries List shared memory entries plus pending approval count #
POST /v1/memory/shared/store Store a tenant-wide shared memory entry (may queue for approval) #
POST /v1/memory/store Append a core memory entry (canonical path) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/brainstormrouter-com/openapi/brainstormrouter-com-memory-api-openapi.yml

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/brainstormrouter-com:brainstormrouter-com-memory-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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

brainstormrouter-com-memory-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BrainstormRouter Memory API
  version: 1.0.0
  description: 'Autonomous AI API Engine — multi-tenant gateway that intelligently routes

    AI traffic across providers with built-in memory, cost optimization, and

    autonomous background processing.


    All `/v1/*` endpoints require an API key via `Authorization: Bearer `.'
  contact:
    name: BrainstormRouter
    url: https://brainstormrouter.com
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
- url: https://api.brainstormrouter.com
  description: Production
security:
- BearerAuth: []
tags:
- name: Memory
paths:
  /auth/memory/blocks:
    get:
      operationId: authMemoryBlocks
      summary: List per-block memory stats for the caller's tenant
      tags:
      - Memory
      x-br-capability-id: auth.memory.blocks
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/entries:
    get:
      operationId: authMemoryEntriesList
      summary: List all core memory entries for the caller's tenant
      tags:
      - Memory
      x-br-capability-id: auth.memory.entries.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
    post:
      operationId: authMemoryEntriesCreate
      summary: Create a core memory entry
      tags:
      - Memory
      x-br-capability-id: auth.memory.entries.create
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                block:
                  type: string
                  enum:
                  - human
                  - system
                  - project
                  - general
              required:
              - fact
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/entries/{id}:
    delete:
      operationId: authMemoryEntriesDelete
      summary: Delete a core memory entry
      tags:
      - Memory
      x-br-capability-id: auth.memory.entries.delete
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
    put:
      operationId: authMemoryEntriesUpdate
      summary: Update a core memory entry (fact text and/or pin status)
      tags:
      - Memory
      x-br-capability-id: auth.memory.entries.update
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                pinned:
                  type: boolean
              required: []
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/pending:
    get:
      operationId: authMemoryPendingList
      summary: List pending memory-write approvals
      tags:
      - Memory
      x-br-capability-id: auth.memory.pending.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/pending/{id}/approve:
    post:
      operationId: authMemoryPendingApprove
      summary: Approve a pending memory write (commits to shared memory)
      tags:
      - Memory
      x-br-capability-id: auth.memory.pending.approve
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                id:
                  type: string
              required:
              - id
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/pending/{id}/reject:
    post:
      operationId: authMemoryPendingReject
      summary: Reject a pending memory write
      tags:
      - Memory
      x-br-capability-id: auth.memory.pending.reject
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                id:
                  type: string
              required:
              - id
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/query:
    post:
      operationId: authMemoryQuery
      summary: Score-rank core memory entries against a query string
      tags:
      - Memory
      x-br-capability-id: auth.memory.query
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                query:
                  type: string
                q:
                  type: string
                limit:
                  type: number
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/shared/entries:
    get:
      operationId: authMemorySharedList
      summary: List shared-memory entries (tenant-wide)
      tags:
      - Memory
      x-br-capability-id: auth.memory.shared.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/memory/shared/store:
    post:
      operationId: authMemorySharedStore
      summary: Store a shared-memory entry (may enqueue for approval)
      tags:
      - Memory
      x-br-capability-id: auth.memory.shared.store
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                block:
                  type: string
                  enum:
                  - human
                  - system
                  - project
                  - general
              required:
              - fact
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /v1/memory/approval-config:
    get:
      operationId: systemMemoryApprovalConfigGet
      summary: Get the memory-write approval-required flag
      tags:
      - Memory
      x-br-capability-id: system.memory.approvalConfig.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    put:
      operationId: systemMemoryApprovalConfigSet
      summary: Set the memory-write approval-required flag
      tags:
      - Memory
      x-br-capability-id: system.memory.approvalConfig.set
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                requireApproval:
                  type: boolean
              required:
              - requireApproval
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/blocks:
    get:
      operationId: systemMemoryBlocksList
      summary: List memory blocks with entry counts (optional ?project= filter)
      tags:
      - Memory
      x-br-capability-id: system.memory.blocks.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/blocks/sync:
    post:
      operationId: systemMemoryBlocksSync
      summary: Bulk upsert core memory entries for a project (Brainstorm CLI)
      tags:
      - Memory
      x-br-capability-id: system.memory.blocks.sync
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                project:
                  type: string
                blocks:
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        value:
                          type: string
                      required:
                      - key
                      - value
                      additionalProperties: false
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/blocks/{block}:
    get:
      operationId: systemMemoryBlocksGet
      summary: List entries in a specific memory block
      tags:
      - Memory
      x-br-capability-id: system.memory.blocks.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/entries:
    get:
      operationId: systemMemoryEntriesList
      summary: List all core memory entries (optional ?project= filter)
      tags:
      - Memory
      x-br-capability-id: system.memory.entries.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    post:
      operationId: systemMemoryEntriesCreate
      summary: Append a new core memory entry (alias for /v1/memory/store)
      tags:
      - Memory
      x-br-capability-id: system.memory.entries.create
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                context:
                  type: string
                block:
                  type: string
                pinned:
                  type: boolean
                project:
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/entries/{id}:
    delete:
      operationId: systemMemoryEntriesDelete
      summary: Delete a memory entry
      tags:
      - Memory
      x-br-capability-id: system.memory.entries.delete
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    put:
      operationId: systemMemoryEntriesUpdate
      summary: Update fact text and/or pin state for an entry
      tags:
      - Memory
      x-br-capability-id: system.memory.entries.update
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                pinned:
                  type: boolean
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/init:
    post:
      operationId: systemMemoryInit
      summary: Bootstrap memory from context documents via LLM extraction
      tags:
      - Memory
      x-br-capability-id: system.memory.init
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                documents:
                  type: array
                  items:
                    type: object
                    properties:
                      content:
                        type: string
                      source:
                        type: string
                    additionalProperties: false
                model:
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/pending:
    get:
      operationId: systemMemoryPendingList
      summary: List pending memory writes (unified queue + legacy)
      tags:
      - Memory
      x-br-capability-id: system.memory.pending.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/pending/{id}/approve:
    post:
      operationId: systemMemoryPendingApprove
      summary: Approve a pending memory write (unified queue or legacy)
      tags:
      - Memory
      x-br-capability-id: system.memory.pending.approve
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties: {}
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/pending/{id}/reject:
    post:
      operationId: systemMemoryPendingReject
      summary: Reject a pending memory write
      tags:
      - Memory
      x-br-capability-id: system.memory.pending.reject
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties: {}
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/query:
    post:
      operationId: systemMemoryQuery
      summary: Relevance-scored memory query (top-N matches)
      tags:
      - Memory
      x-br-capability-id: system.memory.query
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                agent_id:
                  type: string
                query:
                  type: string
                limit:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                project:
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/shared/entries:
    get:
      operationId: systemMemorySharedList
      summary: List shared memory entries plus pending approval count
      tags:
      - Memory
      x-br-capability-id: system.memory.shared.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/shared/store:
    post:
      operationId: systemMemorySharedStore
      summary: Store a tenant-wide shared memory entry (may queue for approval)
      tags:
      - Memory
      x-br-capability-id: system.memory.shared.store
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                context:
                  type: string
                block:
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/memory/store:
    post:
      operationId: systemMemoryStore
      summary: Append a core memory entry (canonical path)
      tags:
      - Memory
      x-br-capability-id: system.memory.store
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                fact:
                  type: string
                context:
                  type: string
                block:
                  type: string
                pinned:
                  type: boolean
                project:
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key (e.g. `br_live_...`)
    SupabaseJWT:
      type: http
      scheme: bearer
      description: Supabase JWT token (dashboard auth)