dialogbrain-com

dialogbrain-com AI Tags API

The ai-tags API from dialogbrain-com — 8 operation(s) for ai-tags.

GitHub OpenAPI

Operations 11

GET /api/ai-tags List Tags #
POST /api/ai-tags Create Tag #
PATCH /api/ai-tags/{tag_id} Update Tag #
DELETE /api/ai-tags/{tag_id} Delete Tag #
POST /api/ai-tags/from-template Create From Template #
PUT /api/ai-tags/reorder Reorder Tags #
POST /api/ai-tags/threads/{thread_id}/tags Add Thread Tags #
GET /api/ai-tags/threads/{thread_id}/tags Get Thread Tags #
DELETE /api/ai-tags/threads/{thread_id}/tags/{tag_id} Remove Thread Tag #
POST /api/ai-tags/reclassify Reclassify Threads #
POST /api/ai-tags/reclassify/cancel Cancel Reclassify #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dialogbrain-com/openapi/dialogbrain-com-ai-tags-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-ai-tags-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-ai-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway AI Tags API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: ai-tags
paths:
  /api/ai-tags:
    get:
      tags:
      - ai-tags
      summary: List Tags
      description: List all AI tags with thread and task counts for the active workspace.
      operationId: list_tags_api_ai_tags_get
      parameters:
      - name: applies_to
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - thread
            - task
            type: string
          - type: 'null'
          title: Applies To
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - ai-tags
      summary: Create Tag
      description: Create a new AI tag.
      operationId: create_tag_api_ai_tags_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTagRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/{tag_id}:
    patch:
      tags:
      - ai-tags
      summary: Update Tag
      description: Update a tag's name, description, icon, color, or active status.
      operationId: update_tag_api_ai_tags__tag_id__patch
      parameters:
      - name: tag_id
        in: path
        required: true
        schema:
          type: integer
          title: Tag Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTagRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - ai-tags
      summary: Delete Tag
      description: Delete a tag. CASCADE removes all junction rows.
      operationId: delete_tag_api_ai_tags__tag_id__delete
      parameters:
      - name: tag_id
        in: path
        required: true
        schema:
          type: integer
          title: Tag Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/from-template:
    post:
      tags:
      - ai-tags
      summary: Create From Template
      description: Bulk create tags from a predefined template.
      operationId: create_from_template_api_ai_tags_from_template_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FromTemplateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/reorder:
    put:
      tags:
      - ai-tags
      summary: Reorder Tags
      description: Update sort_order for tags. tag_ids array defines the new order.
      operationId: reorder_tags_api_ai_tags_reorder_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReorderRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/threads/{thread_id}/tags:
    post:
      tags:
      - ai-tags
      summary: Add Thread Tags
      description: Manually add tags to a thread.
      operationId: add_thread_tags_api_ai_tags_threads__thread_id__tags_post
      parameters:
      - name: thread_id
        in: path
        required: true
        schema:
          type: integer
          title: Thread Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThreadTagsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - ai-tags
      summary: Get Thread Tags
      description: Get all tags on a thread.
      operationId: get_thread_tags_api_ai_tags_threads__thread_id__tags_get
      parameters:
      - name: thread_id
        in: path
        required: true
        schema:
          type: integer
          title: Thread Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/threads/{thread_id}/tags/{tag_id}:
    delete:
      tags:
      - ai-tags
      summary: Remove Thread Tag
      description: Remove a tag from a thread (regardless of manual/auto).
      operationId: remove_thread_tag_api_ai_tags_threads__thread_id__tags__tag_id__delete
      parameters:
      - name: thread_id
        in: path
        required: true
        schema:
          type: integer
          title: Thread Id
      - name: tag_id
        in: path
        required: true
        schema:
          type: integer
          title: Tag Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/reclassify:
    post:
      tags:
      - ai-tags
      summary: Reclassify Threads
      description: 'Trigger batch reclassification of threads.


        Runs as a background task. Returns immediately with job status.

        Progress is reported via WebSocket: channel:ai_tags:reclassify_progress


        Scope options:

        - all: all active non-archived threads

        - recent_30d: threads with messages in last 30 days

        - recent_90d: threads with messages in last 90 days'
      operationId: reclassify_threads_api_ai_tags_reclassify_post
      parameters:
      - name: scope
        in: query
        required: false
        schema:
          type: string
          pattern: ^(all|recent_30d|recent_90d)$
          default: all
          title: Scope
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ai-tags/reclassify/cancel:
    post:
      tags:
      - ai-tags
      summary: Cancel Reclassify
      description: Cancel a running reclassification. Sets a flag checked by the background task.
      operationId: cancel_reclassify_api_ai_tags_reclassify_cancel_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
components:
  schemas:
    TagTarget:
      type: string
      enum:
      - thread
      - task
      - both
      title: TagTarget
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CreateTagRequest:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
        slug:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Slug
        description:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Description
        icon:
          anyOf:
          - type: string
            maxLength: 10
          - type: 'null'
          title: Icon
        color:
          anyOf:
          - type: string
            maxLength: 20
          - type: 'null'
          title: Color
        applies_to:
          $ref: '#/components/schemas/TagTarget'
          default: thread
      type: object
      required:
      - name
      title: CreateTagRequest
    FromTemplateRequest:
      properties:
        template:
          type: string
          title: Template
          description: 'Template name: property_management, sales, restaurant'
      type: object
      required:
      - template
      title: FromTemplateRequest
    ReorderRequest:
      properties:
        tag_ids:
          items:
            type: integer
          type: array
          maxItems: 50
          minItems: 1
          title: Tag Ids
      type: object
      required:
      - tag_ids
      title: ReorderRequest
    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
    UpdateTagRequest:
      properties:
        name:
          anyOf:
          - type: string
            maxLength: 100
            minLength: 1
          - type: 'null'
          title: Name
        slug:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Slug
        description:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Description
        icon:
          anyOf:
          - type: string
            maxLength: 10
          - type: 'null'
          title: Icon
        color:
          anyOf:
          - type: string
            maxLength: 20
          - type: 'null'
          title: Color
        is_active:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Active
        applies_to:
          anyOf:
          - $ref: '#/components/schemas/TagTarget'
          - type: 'null'
      type: object
      title: UpdateTagRequest
    ThreadTagsRequest:
      properties:
        tag_ids:
          items:
            type: integer
          type: array
          maxItems: 20
          minItems: 1
          title: Tag Ids
      type: object
      required:
      - tag_ids
      title: ThreadTagsRequest