dialogbrain-com Listen Public API
The listen-public API from dialogbrain-com — 4 operation(s) for listen-public.
The listen-public API from dialogbrain-com — 4 operation(s) for listen-public.
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-listen-public-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 Listen Public API
description: Clean refactored API gateway with minimal vertical slice
version: 0.1.0
tags:
- name: listen-public
paths:
/public/listen/{token}/session:
get:
tags:
- listen-public
summary: Public Session
description: 'Fetch session metadata for a public listener link.
Args:
token: Share token from URL.
db: Shared database session.
Returns:
Session metadata: active status, title, languages.
Raises:
HTTPException: 404 if token invalid/revoked/expired.'
operationId: public_session_public_listen__token__session_get
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
- name: lang
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Lang
- name: pid
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pid
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PublicSessionResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/public/listen/{token}/join:
post:
tags:
- listen-public
summary: Public Join
description: 'Mint a subscribe-only LiveKit token for a public listener.
Args:
token: Share token from URL.
pid: Stable per-page listener id (same value the /live page beacons).
Used as the LiveKit identity so a rejoin replaces the listener''s
previous participant instead of stacking a duplicate.
db: Shared database session.
Returns:
LiveKit credentials: url, token, room name.
Raises:
HTTPException: 404 if token invalid/revoked/expired.
HTTPException: 409 if no active call.'
operationId: public_join_public_listen__token__join_post
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
- name: pid
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pid
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PublicJoinResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/public/listen/{token}/request-language:
post:
tags:
- listen-public
summary: Public Request Language
description: 'Listener-driven language activation (Glossa-style "any language").
Adds the requested language to the live call''s app-only translation
list via the SAME runtime call the in-app MeetLanguageSwitcher uses
(`set_translation_languages` — server-enforced MAX_APP_TARGET_LANGS
cap, new utterances only, no backfill). Public abuse surface is
bounded by: supported-code validation, the per-call cap, the armed
no-op fast path, and a per-token cooldown.'
operationId: public_request_language_public_listen__token__request_language_post
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RequestLanguageBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/RequestLanguageResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/public/listen/{token}/transcript:
get:
tags:
- listen-public
summary: Public Transcript
description: 'Fetch transcript for an active call with pagination.
Args:
token: Share token from URL.
since_id: Pagination cursor (return turns with id > since_id).
db: Shared database session.
Returns:
Paginated transcript: turns (id, speaker, original, translated) and last_id.
Raises:
HTTPException: 404 if token invalid/revoked/expired.'
operationId: public_transcript_public_listen__token__transcript_get
parameters:
- name: token
in: path
required: true
schema:
type: string
title: Token
- name: since_id
in: query
required: false
schema:
type: integer
default: 0
title: Since Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PublicTranscriptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
RequestLanguageBody:
properties:
lang:
type: string
title: Lang
type: object
required:
- lang
title: RequestLanguageBody
RequestLanguageResponse:
properties:
available_langs:
items:
type: string
type: array
title: Available Langs
type: object
required:
- available_langs
title: RequestLanguageResponse
TranscriptTurn:
properties:
id:
type: integer
title: Id
speaker:
anyOf:
- type: string
- type: 'null'
title: Speaker
original:
anyOf:
- type: string
- type: 'null'
title: Original
translated:
anyOf:
- type: string
- type: 'null'
title: Translated
translations:
additionalProperties:
type: string
type: object
title: Translations
default: {}
sent_at:
anyOf:
- type: string
- type: 'null'
title: Sent At
type: object
required:
- id
- speaker
- original
- translated
title: TranscriptTurn
description: A single turn in the transcript.
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
PublicSessionResponse:
properties:
active:
type: boolean
title: Active
title:
type: string
title: Title
source_lang:
anyOf:
- type: string
- type: 'null'
title: Source Lang
target_lang:
anyOf:
- type: string
- type: 'null'
title: Target Lang
available_langs:
items:
type: string
type: array
title: Available Langs
default: []
call_tts_muted:
type: boolean
title: Call Tts Muted
default: false
type: object
required:
- active
- title
title: PublicSessionResponse
description: Session metadata for public listeners.
PublicJoinResponse:
properties:
url:
type: string
title: Url
token:
type: string
title: Token
room:
type: string
title: Room
type: object
required:
- url
- token
- room
title: PublicJoinResponse
description: LiveKit credentials for public listeners.
PublicTranscriptResponse:
properties:
turns:
items:
$ref: '#/components/schemas/TranscriptTurn'
type: array
title: Turns
last_id:
type: integer
title: Last Id
type: object
required:
- turns
- last_id
title: PublicTranscriptResponse
description: Transcript with pagination.