---
title: "Analyze which assistants would be affected if this tool revision is promoted"
method: GET
path: "/v1/tools/{tool_id}/revisions/{revision_id}/impact"
tags: ["tools"]
---

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

`GET /v1/tools/{tool_id}/revisions/{revision_id}/impact`

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

## Path parameters

- `tool_id` string, uuid, required
- `revision_id` string, uuid, required

## Response `200`

Successful Response

- ToolCompatibilityReportResponse — 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).
  - `tool_id` string, uuid, required
  - `old_revision_id` string, uuid, nullable, required
  - `new_revision_id` string, uuid, required
  - `findings` ToolCompatibilityFindingResponse[]
    - `severity` 'blocking' | 'advisory', required
    - `assistant_id` string, uuid, required
    - `assistant_revision_id` string, uuid, required
    - `revision_state` 'active' | 'candidate' | 'historical', required
    - `finding_type` string, required
    - `field_path` string, required
    - `detail` string, required
    - `configuration_scope` 'assistant_tool_default' | 'agent_node_tool' | 'action_step_tool', required
    - `workflow_id` string, uuid, nullable
    - `workflow_revision_id` string, uuid, nullable
    - `component_node_id` string, nullable
    - `graph_node_id` string, nullable
    - `graph_node_name` string, nullable
    - `step_id` string, nullable
    - `tool_ref_index` integer, nullable
  - `has_blocking` boolean, required
  - `active_blocking_count` integer, required
  - `active_blocking_finding_count` integer, required
  - `active_finding_count` integer, required
  - `affected_assistant_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-12** `5a5597ebb2d6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oneloop-hq/apis/feather-api/changes/v1/tools/:tool_id/revisions/:revision_id/impact/get.md)

---

[API](https://skmtc.dev/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.dev/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oneloop-hq/apis/feather-api/revisions/9cd7291d4228?raw)