dialogbrain-com Memory API
The memory API from dialogbrain-com — 5 operation(s) for memory.
The memory API from dialogbrain-com — 5 operation(s) for memory.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/dialogbrain-com:dialogbrain-com-memory-api"
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.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: DialogBrain v2 API Gateway Memory API
description: Clean refactored API gateway with minimal vertical slice
version: 0.1.0
tags:
- name: Memory
paths:
/api/memory:
get:
tags:
- Memory
summary: List Memory
description: 'Paginated list with filters. Default: active rows only.
Permission: READ_INTERNAL (member floor — not the public ''viewer'' tier).'
operationId: list_memory_api_memory_get
parameters:
- name: scope
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Filter: workspace|agent|thread|person'
title: Scope
description: 'Filter: workspace|agent|thread|person'
- name: memory_type
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Memory Type
- name: source
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Source
- name: agent_id
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Agent Id
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Free-text match on key + value->>'rule'
title: Q
description: Free-text match on key + value->>'rule'
- name: include_tombstoned
in: query
required: false
schema:
type: boolean
default: false
title: Include Tombstoned
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
title: Page
- name: per_page
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Per Page
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MemoryListOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/memory/{memory_id}:
patch:
tags:
- Memory
summary: Edit Memory
description: 'Edit value. Promotes the row to source=''user_edit'', confidence=1.0
so it becomes load-bearing and protected from distiller supersession.
Permission: ADMIN (owner+admin).'
operationId: edit_memory_api_memory__memory_id__patch
parameters:
- name: memory_id
in: path
required: true
schema:
type: integer
title: Memory Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MemoryEditIn'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MemoryRowOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Memory
summary: Delete Memory
description: 'Tombstone with reason=''user_delete''. Row stays in DB so the
distiller''s Section C do-not-recreate set picks it up.
Permission: ADMIN.'
operationId: delete_memory_api_memory__memory_id__delete
parameters:
- name: memory_id
in: path
required: true
schema:
type: integer
title: Memory Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MemoryRowOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/memory/bulk-tombstone:
post:
tags:
- Memory
summary: Bulk Tombstone
description: 'Tombstone all rows matching filter, reason=''user_delete''. Body
must specify at least one filter — empty filter is rejected to
prevent accidental "wipe all memory" calls.
Permission: ADMIN.'
operationId: bulk_tombstone_api_memory_bulk_tombstone_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BulkTombstoneIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BulkTombstoneOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/memory/audit:
get:
tags:
- Memory
summary: List Audit
description: 'Paginated audit-log query. Default window 7 days for
partition-pruning hint (memory_audit_log is RANGE-partitioned monthly).
Permission: ADMIN.'
operationId: list_audit_api_memory_audit_get
parameters:
- name: memory_id
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Memory Id
- name: days
in: query
required: false
schema:
type: integer
maximum: 90
minimum: 1
default: 7
title: Days
- name: per_page
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Per Page
- name: cursor
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: Last seen audit id; returns rows with id < cursor
title: Cursor
description: Last seen audit id; returns rows with id < cursor
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AuditListOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/memory/settings:
get:
tags:
- Memory
summary: Get Settings
description: 'Read-only view of the workspace memory toggles. VIEW permission
so members can see whether memory is on without being able to flip it.'
operationId: get_settings_api_memory_settings_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SettingsOut'
post:
tags:
- Memory
summary: Set Settings
description: 'Toggle workspace.memory_enabled and/or memory_auto_distill.
Permission: OWNER only (highest-impact switch in the system —
flipping it off pauses every write path and read path).'
operationId: set_settings_api_memory_settings_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SettingsIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SettingsOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
MemoryEditIn:
properties:
value:
additionalProperties: true
type: object
title: Value
description: New JSONB value
type: object
required:
- value
title: MemoryEditIn
AuditEntryOut:
properties:
id:
type: integer
title: Id
memory_id:
type: integer
title: Memory Id
action:
type: string
title: Action
actor_user_id:
anyOf:
- type: integer
- type: 'null'
title: Actor User Id
actor_system:
anyOf:
- type: string
- type: 'null'
title: Actor System
before_value:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Before Value
after_value:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: After Value
created_at:
type: string
title: Created At
type: object
required:
- id
- memory_id
- action
- actor_user_id
- actor_system
- created_at
title: AuditEntryOut
SettingsIn:
properties:
memory_enabled:
anyOf:
- type: boolean
- type: 'null'
title: Memory Enabled
memory_auto_distill:
anyOf:
- type: boolean
- type: 'null'
title: Memory Auto Distill
type: object
title: SettingsIn
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
BulkTombstoneOut:
properties:
tombstoned:
type: integer
title: Tombstoned
type: object
required:
- tombstoned
title: BulkTombstoneOut
MemoryRowOut:
properties:
id:
type: integer
title: Id
agent_id:
type: integer
title: Agent Id
scope:
type: string
title: Scope
scope_ref_id:
anyOf:
- type: string
- type: 'null'
title: Scope Ref Id
memory_type:
type: string
title: Memory Type
key:
type: string
title: Key
value:
additionalProperties: true
type: object
title: Value
source:
type: string
title: Source
confidence:
type: number
title: Confidence
source_message_ids:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Source Message Ids
created_at:
anyOf:
- type: string
- type: 'null'
title: Created At
updated_at:
anyOf:
- type: string
- type: 'null'
title: Updated At
type: object
required:
- id
- agent_id
- scope
- scope_ref_id
- memory_type
- key
- value
- source
- confidence
title: MemoryRowOut
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
MemoryListOut:
properties:
items:
items:
$ref: '#/components/schemas/MemoryRowOut'
type: array
title: Items
total:
type: integer
title: Total
page:
type: integer
title: Page
per_page:
type: integer
title: Per Page
has_more:
type: boolean
title: Has More
type: object
required:
- items
- total
- page
- per_page
- has_more
title: MemoryListOut
SettingsOut:
properties:
memory_enabled:
type: boolean
title: Memory Enabled
memory_auto_distill:
type: boolean
title: Memory Auto Distill
type: object
required:
- memory_enabled
- memory_auto_distill
title: SettingsOut
AuditListOut:
properties:
items:
items:
$ref: '#/components/schemas/AuditEntryOut'
type: array
title: Items
has_more:
type: boolean
title: Has More
type: object
required:
- items
- has_more
title: AuditListOut
BulkTombstoneIn:
properties:
scope:
anyOf:
- type: string
- type: 'null'
title: Scope
scope_ref_id:
anyOf:
- type: string
- type: 'null'
title: Scope Ref Id
memory_type:
anyOf:
- type: string
- type: 'null'
title: Memory Type
agent_id:
anyOf:
- type: integer
- type: 'null'
title: Agent Id
source:
anyOf:
- type: string
- type: 'null'
title: Source
type: object
title: BulkTombstoneIn