---
title: "Update Insights Tool Configuration"
method: PUT
path: "/api/v1/insights/tool-configurations/{tool_id}"
tags: ["insights.tools"]
---

# Update Insights Tool Configuration

`PUT /api/v1/insights/tool-configurations/{tool_id}`

Update an Insights tool.

## Path parameters

- `tool_id` integer, required

## Request body

- InsightToolInput — Request model to create/update an insight tool configuration.
  - `name` string, required — Human readable name of insight tool
  - `description` string, required — Text description of insight tool configuration
  - `version` integer, required — Version number of insight tool configuration
  - `tool_arguments` unknown, required
  - `insight_tool_definition_id` integer, required — Internal ID for the definition used by the insight tool configuration

## Response `200`

Successful Response

- InsightToolResponse — Response model for insight tool saves, carrying any non-blocking findings.
  - `name` string, required — Human readable name of insight tool
  - `description` string, required — Text description of insight tool configuration
  - `version` integer, required — Version of insight tool
  - `tool_arguments` unknown, required
  - `insight_tool_definition_id` integer, required — Unique ID for insight tool definition used by this tool configuration
  - `id` integer, required — Unique ID for insight tool
  - `insight_tool_definition` InsightToolDefinition — Model for an insight tool definition. This is a template that can be used by multiple insight tool configurations, each providing their own parameter values.
    - `id` integer, required — Unique ID for insight tool definition
    - `name` string, required — Human-readable name of insight tool definition
    - `type` string, required — Type of insight tool definition
    - `description` string, required — Text description of insight tool definition
    - `tool_parameters` unknown, required
    - `tool_result_set` unknown, required
  - `created_at` string, date-time — Timestamp of at which insight tool configuration was created
  - `updated_at` string, date-time — Timestamp at which insight tool configuration was last updated
  - `last_updated_by` string, required — Email of user who last updated insight tool configuration
  - `validation_issues` ValidationIssue[], nullable — Non-blocking findings for the saved insight tool (e.g. a deprecated model warning). Warnings and infos are informational; errors block the save.
    - `id` string, required — Stable machine-readable identifier (kebab-case)
    - `severity` 'info' | 'warning' | 'error'
    - `message` string, required — Human-readable description
    - `path` string, nullable — JSONPath-style location (e.g. $.context.task.steps[2])
    - `value` string, nullable — The offending value, when it adds clarity

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/revisions/f829ded48985/schema)