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/dialogbrain-com:dialogbrain-com-memory-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

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