dialogbrain-com Prompt Blocks API

openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway Prompt Blocks API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: Prompt Blocks
paths:
  /api/v1/prompt-blocks:
    get:
      tags:
      - Prompt Blocks
      summary: List Prompt Blocks
      description: 'List every block the platform assembles into an agent''s system prompt: id, kind, order and whether it can be disabled or rewritten.'
      operationId: list_prompt_blocks_api_v1_prompt_blocks_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/agents/{agent_id}/prompt-blocks:
    get:
      tags:
      - Prompt Blocks
      summary: Get Agent Prompt Blocks
      description: 'Return the agent''s prompt-block overrides layered on the workspace''s: which blocks are disabled and which have custom text.'
      operationId: get_agent_prompt_blocks_api_v1_agents__agent_id__prompt_blocks_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - Prompt Blocks
      summary: Put Agent Prompt Blocks
      description: Replace the agent's prompt-block overrides. Send the complete desired set; blocks not listed revert to the workspace default.
      operationId: put_agent_prompt_blocks_api_v1_agents__agent_id__prompt_blocks_put
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptBlocksPut'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/prompt-blocks/registry:
    get:
      tags:
      - Prompt Blocks
      summary: Get Registry
      operationId: get_registry_api_prompt_blocks_registry_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/prompt-blocks/workspace:
    get:
      tags:
      - Prompt Blocks
      summary: Get Workspace Blocks
      operationId: get_workspace_blocks_api_prompt_blocks_workspace_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    put:
      tags:
      - Prompt Blocks
      summary: Put Workspace Blocks
      operationId: put_workspace_blocks_api_prompt_blocks_workspace_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptBlocksPayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/prompt-blocks/agents/{agent_id}:
    get:
      tags:
      - Prompt Blocks
      summary: Get Agent Blocks
      operationId: get_agent_blocks_api_prompt_blocks_agents__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - Prompt Blocks
      summary: Put Agent Blocks
      operationId: put_agent_blocks_api_prompt_blocks_agents__agent_id__put
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptBlocksPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/prompt-blocks/agents/{agent_id}/preview:
    post:
      tags:
      - Prompt Blocks
      summary: Preview Agent Prompt
      operationId: preview_agent_prompt_api_prompt_blocks_agents__agent_id__preview_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/src__api__prompt_blocks__PreviewRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PromptBlocksPut:
      properties:
        prompt_blocks:
          additionalProperties: true
          type: object
          title: Prompt Blocks
          description: '{block_id: {enabled, text, order, hidden_rows}}. Omit a key to remove its override; null only for one already stored. Read GET /api/v1/prompt-blocks for valid ids.'
      type: object
      required:
      - prompt_blocks
      title: PromptBlocksPut
      description: 'The complete set of prompt-block overrides for this agent. Replacement is per block: a block you omit is removed; inside a block, fields you omit keep their stored value. To remove an override, omit its key; null is accepted only for an override that is already stored.'
    src__api__prompt_blocks__PreviewRequest:
      properties:
        thread_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Thread Id
      type: object
      title: PreviewRequest
    PromptBlocksPayload:
      properties:
        prompt_blocks:
          additionalProperties:
            anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          type: object
          title: Prompt Blocks
      type: object
      title: PromptBlocksPayload