---
title: "Update Agent Tool"
method: PATCH
path: "/api/v1/agent-integrations/tools/{tool_id}"
tags: ["agent-integrations"]
---

# Update Agent Tool

`PATCH /api/v1/agent-integrations/tools/{tool_id}`

Update an agent tool configuration (partial update).

## Path parameters

- `tool_id` string, uuid, required

## Request body

- UpdateAgentToolRequest — Request to update an agent tool's configuration.
  - `enabled` boolean, nullable
  - `condition` string, nullable
  - `display_name` string, nullable
  - `description` string, nullable

## Response `200`

Successful Response

- AgentIntegrationToolRead — Response schema for agent integration tool.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `agent_integration_id` string, uuid, required
  - `tool_name` string, required
  - `executor_type` 'composio' | 'sms' | 'transfer' | 'email' | 'internal' | 'practice_better' | 'webhotelier' | 'knowledge_base' | 'datetime' | 'fidelio' | 'customer_context' | 'call_session' | 'intelligence' | 'weather' | 'exchange_rate' | 'holidays' | 'predicthq' | 'news' | 'handoff' | 'voice_agent_transfer' | 'sub_agent' | 'genesys_cloud' | 'email_verification' | 'analytics_chat' | 'hubspot' | 'web_search' | 'guide_write' | 'guide_read' | 'navigation' | 'metrics_catalog' | 'cloudflare' | 'geo_insights' | 'google_ads' | 'google_analytics' | 'wordpress' | 'website' | 'box' | 'tripadvisor' | 'posthog' | 'github' | 'docs' | 'mews' | 'action_follow_up' | 'actions_chat', required — Executor type determines which ToolRegistry executor handles this tool. This is the routing key for tool execution - provider-agnostic.
  - `provider` string, nullable, required
  - `provider_action_name` string, nullable, required
  - `display_name` string, required
  - `description` string, required
  - `condition` string, nullable, required
  - `params_schema` object, required
  - `enabled` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-09-22** `0b211d6e9f84` — 1 warning
  - added the new `actions_chat` enum value to the `executor_type` response property for the response status `200`
- **2026-09-15** `41c5e4645524` — 1 warning
  - added the new `action_follow_up` enum value to the `executor_type` response property for the response status `200`
- **2026-09-08** `0d816626f362` — 1 warning
  - added the new `mews` enum value to the `executor_type` response property for the response status `200`
- **2026-09-04** `a9141b6e4e7e` — 1 warning
  - added the new `docs` enum value to the `executor_type` response property for the response status `200`
- **2026-09-03** `d65b8fefae34` — 1 warning, 2 info
  - added the new `github` enum value to the `executor_type` response property for the response status `200`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Full history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/agent-integrations/tools/:tool_id/patch.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/704de2d43c75?raw)