dialogbrain-com Strategy API
The strategy API from dialogbrain-com — 12 operation(s) for strategy.
The strategy API from dialogbrain-com — 12 operation(s) for strategy.
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-strategy-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 Strategy API
description: Clean refactored API gateway with minimal vertical slice
version: 0.1.0
tags:
- name: strategy
paths:
/api/strategy/states:
get:
tags:
- strategy
summary: List States
description: 'List all contact states with counts.
Returns count of contacts in each state, plus policy info.'
operationId: list_states_api_strategy_states_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatesListResponse'
/api/strategy/prompts:
get:
tags:
- strategy
summary: List Prompts
description: 'Get all prompt templates for current user.
Returns user''s custom prompts merged with defaults.'
operationId: list_prompts_api_strategy_prompts_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/src__api__strategy__PromptsListResponse'
/api/strategy/prompts/{state}:
put:
tags:
- strategy
summary: Update Prompt
description: 'Update prompt template for a state.
Creates user override if none exists.'
operationId: update_prompt_api_strategy_prompts__state__put
parameters:
- name: state
in: path
required: true
schema:
type: string
title: State
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/src__api__strategy__UpdatePromptRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/src__api__strategy__PromptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/prompts/{state}/reset:
post:
tags:
- strategy
summary: Reset Prompt
description: 'Reset prompt template to default.
Deletes user''s custom prompt for this state.'
operationId: reset_prompt_api_strategy_prompts__state__reset_post
parameters:
- name: state
in: path
required: true
schema:
type: string
title: State
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/src__api__strategy__PromptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/contacts:
get:
tags:
- strategy
summary: List Contacts By State
description: 'List contacts, optionally filtered by state.
Returns contacts with their state info and policy.'
operationId: list_contacts_by_state_api_strategy_contacts_get
parameters:
- name: state
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: State
- name: limit
in: query
required: false
schema:
type: integer
default: 50
title: Limit
- name: offset
in: query
required: false
schema:
type: integer
default: 0
title: Offset
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ContactsListResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/contacts/{person_id}:
get:
tags:
- strategy
summary: Get Contact State
description: Get detailed state info for a contact.
operationId: get_contact_state_api_strategy_contacts__person_id__get
parameters:
- name: person_id
in: path
required: true
schema:
type: integer
title: Person Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ContactStateResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/contacts/{person_id}/refresh:
post:
tags:
- strategy
summary: Refresh Contact State
description: Force recalculation of contact state.
operationId: refresh_contact_state_api_strategy_contacts__person_id__refresh_post
parameters:
- name: person_id
in: path
required: true
schema:
type: integer
title: Person Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ContactStateResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/contacts/recalculate-all:
post:
tags:
- strategy
summary: Bulk Recalculate States
description: 'Bulk recalculate contact states for all contacts without a state.
This is useful for initial population or after schema changes.
Processes contacts in batches to avoid timeouts.'
operationId: bulk_recalculate_states_api_strategy_contacts_recalculate_all_post
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 2000
description: Max contacts to process
default: 500
title: Limit
description: Max contacts to process
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BulkRecalculateResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/preview:
post:
tags:
- strategy
summary: Preview Prompt
description: 'Preview a prompt with test data.
Renders the prompt with sample variables and optionally calls
the LLM to generate a response preview.'
operationId: preview_prompt_api_strategy_preview_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewPromptRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewPromptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/group-prompts:
get:
tags:
- strategy
summary: List Group Prompts
description: List all 5 group outbound prompts (merged user overrides + defaults).
operationId: list_group_prompts_api_strategy_group_prompts_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GroupPromptsListResponse'
/api/strategy/group-prompts/{state}:
put:
tags:
- strategy
summary: Update Group Prompt
description: Update group outbound prompt for a state.
operationId: update_group_prompt_api_strategy_group_prompts__state__put
parameters:
- name: state
in: path
required: true
schema:
type: string
title: State
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateGroupPromptRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GroupPromptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/strategy/group-prompts/{state}/reset:
post:
tags:
- strategy
summary: Reset Group Prompt
description: Reset group outbound prompt to default for a state.
operationId: reset_group_prompt_api_strategy_group_prompts__state__reset_post
parameters:
- name: state
in: path
required: true
schema:
type: string
title: State
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GroupPromptResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
UpdateGroupPromptRequest:
properties:
prompt_text:
anyOf:
- type: string
- type: 'null'
title: Prompt Text
description: Prompt text for group outreach
tone:
anyOf:
- type: string
- type: 'null'
title: Tone
description: 'Tone: curious, friendly, professional, casual, warm, neutral'
max_words:
anyOf:
- type: integer
maximum: 200.0
minimum: 10.0
- type: 'null'
title: Max Words
description: Word limit (10-200)
type: object
title: UpdateGroupPromptRequest
description: Request to update a group outbound prompt.
PreviewPromptResponse:
properties:
rendered_prompt:
type: string
title: Rendered Prompt
model_response:
type: string
title: Model Response
tokens_used:
anyOf:
- type: integer
- type: 'null'
title: Tokens Used
type: object
required:
- rendered_prompt
- model_response
title: PreviewPromptResponse
description: Response from prompt preview.
PreviewPromptRequest:
properties:
state:
type: string
title: State
description: Contact state to preview
mode:
type: string
title: Mode
description: 'Mode: ''reply'' or ''outbound'''
dummy_message:
anyOf:
- type: string
- type: 'null'
title: Dummy Message
description: Test message for preview
prompts_override:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Prompts Override
description: Override prompts without saving
type: object
required:
- state
- mode
title: PreviewPromptRequest
description: Request to preview a prompt with test data.
ContactStateResponse:
properties:
person_id:
type: integer
title: Person Id
display_name:
anyOf:
- type: string
- type: 'null'
title: Display Name
state:
type: string
title: State
state_display:
type: string
title: State Display
reason_codes:
items:
type: string
type: array
title: Reason Codes
reason_labels:
items:
type: string
type: array
title: Reason Labels
signal_score:
type: number
title: Signal Score
segment:
type: string
title: Segment
is_dormant:
type: boolean
title: Is Dormant
days_since_last:
anyOf:
- type: integer
- type: 'null'
title: Days Since Last
reply_mode:
type: string
title: Reply Mode
outbound_mode:
type: string
title: Outbound Mode
type: object
required:
- person_id
- display_name
- state
- state_display
- reason_codes
- reason_labels
- signal_score
- segment
- is_dormant
- days_since_last
- reply_mode
- outbound_mode
title: ContactStateResponse
description: Contact state details.
GroupPromptResponse:
properties:
state:
type: string
title: State
prompt_text:
type: string
title: Prompt Text
tone:
type: string
title: Tone
max_words:
type: integer
title: Max Words
is_custom:
type: boolean
title: Is Custom
type: object
required:
- state
- prompt_text
- tone
- max_words
- is_custom
title: GroupPromptResponse
description: Group outbound prompt for a single state.
ContactsListResponse:
properties:
contacts:
items:
$ref: '#/components/schemas/ContactStateResponse'
type: array
title: Contacts
total:
type: integer
title: Total
state_filter:
anyOf:
- type: string
- type: 'null'
title: State Filter
type: object
required:
- contacts
- total
- state_filter
title: ContactsListResponse
description: Response for listing contacts by state.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
BulkRecalculateResponse:
properties:
processed:
type: integer
title: Processed
updated:
type: integer
title: Updated
errors:
type: integer
title: Errors
message:
type: string
title: Message
type: object
required:
- processed
- updated
- errors
- message
title: BulkRecalculateResponse
description: Response for bulk state recalculation.
src__api__strategy__UpdatePromptRequest:
properties:
outbound_prompt:
anyOf:
- type: string
- type: 'null'
title: Outbound Prompt
description: Prompt for outbound messages
reply_prompt:
anyOf:
- type: string
- type: 'null'
title: Reply Prompt
description: Prompt for reply messages
tone:
anyOf:
- type: string
- type: 'null'
title: Tone
description: 'Tone: curious, friendly, professional, casual, warm, neutral'
max_words:
anyOf:
- type: integer
maximum: 200.0
minimum: 10.0
- type: 'null'
title: Max Words
description: Word limit (10-200)
language:
anyOf:
- type: string
- type: 'null'
title: Language
description: 'Language code: ru, en, or null for auto'
reply_mode:
anyOf:
- type: string
- type: 'null'
title: Reply Mode
description: 'Reply mode: off, draft, send'
cooldown_minutes:
anyOf:
- type: number
maximum: 60.0
minimum: 0.0
- type: 'null'
title: Cooldown Minutes
description: Cooldown between replies (0-60 min)
outbound_mode:
anyOf:
- type: string
- type: 'null'
title: Outbound Mode
description: 'Outbound mode: off, draft, send'
max_replies_per_day:
anyOf:
- type: integer
maximum: 100.0
minimum: 1.0
- type: 'null'
title: Max Replies Per Day
description: Max auto-replies per day (1-100)
type: object
title: UpdatePromptRequest
description: Request to update a prompt.
StatesListResponse:
properties:
states:
items:
$ref: '#/components/schemas/StateCountResponse'
type: array
title: States
total:
type: integer
title: Total
type: object
required:
- states
- total
title: StatesListResponse
description: Response for listing all states.
StateCountResponse:
properties:
state:
type: string
title: State
display_name:
type: string
title: Display Name
count:
type: integer
title: Count
reply_mode:
type: string
title: Reply Mode
outbound_mode:
type: string
title: Outbound Mode
description:
type: string
title: Description
type: object
required:
- state
- display_name
- count
- reply_mode
- outbound_mode
- description
title: StateCountResponse
description: Count of contacts per state.
GroupPromptsListResponse:
properties:
prompts:
items:
$ref: '#/components/schemas/GroupPromptResponse'
type: array
title: Prompts
type: object
required:
- prompts
title: GroupPromptsListResponse
description: All group outbound prompts.
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
src__api__strategy__PromptResponse:
properties:
state:
type: string
title: State
outbound_prompt:
type: string
title: Outbound Prompt
reply_prompt:
type: string
title: Reply Prompt
tone:
type: string
title: Tone
max_words:
type: integer
title: Max Words
language:
anyOf:
- type: string
- type: 'null'
title: Language
is_custom:
type: boolean
title: Is Custom
reply_mode:
type: string
title: Reply Mode
default: draft
cooldown_minutes:
type: number
title: Cooldown Minutes
default: 0.0
outbound_mode:
type: string
title: Outbound Mode
default: draft
max_replies_per_day:
type: integer
title: Max Replies Per Day
default: 10
type: object
required:
- state
- outbound_prompt
- reply_prompt
- tone
- max_words
- language
- is_custom
title: PromptResponse
description: Prompt template response.
src__api__strategy__PromptsListResponse:
properties:
prompts:
items:
$ref: '#/components/schemas/src__api__strategy__PromptResponse'
type: array
title: Prompts
type: object
required:
- prompts
title: PromptsListResponse
description: Response for listing all prompts.