> ## Documentation Index
> Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyze which assistants would be affected if this tool revision is promoted

> Impact analysis: which assistants use this tool and have configurations
incompatible with the specified revision? Pre-prod: advisory only — the
promotion itself always succeeds.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/tools/{tool_id}/revisions/{revision_id}/impact
openapi: 3.1.0
info:
  title: Feather API
  description: >-
    Unified customer experience platform API. Manages identity, conversations,
    memory, agents, procedures, policies, model routing, knowledge bases,
    integrations, and runtime execution.
  version: 1.87.0
servers:
  - url: https://api-sandbox.featherhq.com
    description: Sandbox
  - url: http://localhost:8000
    description: Local dev
security: []
paths:
  /v1/tools/{tool_id}/revisions/{revision_id}/impact:
    get:
      tags:
        - tools
      summary: >-
        Analyze which assistants would be affected if this tool revision is
        promoted
      description: |-
        Impact analysis: which assistants use this tool and have configurations
        incompatible with the specified revision? Pre-prod: advisory only — the
        promotion itself always succeeds.
      operationId: getToolRevisionImpact
      parameters:
        - name: tool_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Tool Id
        - name: revision_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Revision Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolCompatibilityReportResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    ToolCompatibilityReportResponse:
      properties:
        tool_id:
          type: string
          format: uuid
          title: Tool Id
        old_revision_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Old Revision Id
        new_revision_id:
          type: string
          format: uuid
          title: New Revision Id
        findings:
          items:
            $ref: '#/components/schemas/ToolCompatibilityFindingResponse'
          type: array
          title: Findings
        has_blocking:
          type: boolean
          title: Has Blocking
        active_blocking_count:
          type: integer
          title: Active Blocking Count
        active_blocking_finding_count:
          type: integer
          title: Active Blocking Finding Count
        active_finding_count:
          type: integer
          title: Active Finding Count
        affected_assistant_count:
          type: integer
          title: Affected Assistant Count
      type: object
      required:
        - tool_id
        - old_revision_id
        - new_revision_id
        - has_blocking
        - active_blocking_count
        - active_blocking_finding_count
        - active_finding_count
        - affected_assistant_count
      title: ToolCompatibilityReportResponse
      description: >-
        Impact report shared by preflight analysis and successful promotion.


        Pre-prod: findings are advisory warnings — promotion always succeeds.
        The

        ``has_blocking`` / ``active_blocking_*`` fields retain their literal

        blocking semantics (and therefore remain false/zero today).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ToolCompatibilityFindingResponse:
      properties:
        severity:
          type: string
          enum:
            - blocking
            - advisory
          title: Severity
        assistant_id:
          type: string
          format: uuid
          title: Assistant Id
        assistant_revision_id:
          type: string
          format: uuid
          title: Assistant Revision Id
        revision_state:
          type: string
          enum:
            - active
            - candidate
            - historical
          title: Revision State
        finding_type:
          type: string
          title: Finding Type
        field_path:
          type: string
          title: Field Path
        detail:
          type: string
          title: Detail
        configuration_scope:
          type: string
          enum:
            - assistant_tool_default
            - agent_node_tool
            - action_step_tool
          title: Configuration Scope
        workflow_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Workflow Id
        workflow_revision_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Workflow Revision Id
        component_node_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Component Node Id
        graph_node_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Graph Node Id
        graph_node_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Graph Node Name
        step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Step Id
        tool_ref_index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Tool Ref Index
      type: object
      required:
        - severity
        - assistant_id
        - assistant_revision_id
        - revision_state
        - finding_type
        - field_path
        - detail
        - configuration_scope
      title: ToolCompatibilityFindingResponse
      description: One frontend-navigable tool-revision compatibility finding.
    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
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````