dialogbrain-com

dialogbrain-com Strategy API

The strategy API from dialogbrain-com — 12 operation(s) for strategy.

GitHub OpenAPI

Operations 12

GET /api/strategy/states List States #
GET /api/strategy/prompts List Prompts #
PUT /api/strategy/prompts/{state} Update Prompt #
POST /api/strategy/prompts/{state}/reset Reset Prompt #
GET /api/strategy/contacts List Contacts By State #
GET /api/strategy/contacts/{person_id} Get Contact State #
POST /api/strategy/contacts/{person_id}/refresh Refresh Contact State #
POST /api/strategy/contacts/recalculate-all Bulk Recalculate States #
POST /api/strategy/preview Preview Prompt #
GET /api/strategy/group-prompts List Group Prompts #
PUT /api/strategy/group-prompts/{state} Update Group Prompt #
POST /api/strategy/group-prompts/{state}/reset Reset Group Prompt #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dialogbrain-com/openapi/dialogbrain-com-strategy-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-agent-update-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-src-api-v1-tool-schema-widget-update-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-src-api-livechat-config-widget-update-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-src-api-livechat-config-widget-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-post-sessions-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dialogbrain-com/json-schema/dialogbrain-com-trigger-update-request-schema.json

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/dialogbrain-com:dialogbrain-com-strategy-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

dialogbrain-com-strategy-api-openapi.yml Raw ↑ 
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.