Skip to main content
PUT
/
api
/
v1
/
insights
/
tool-configurations
/
{tool_id}
Python (SDK)
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.insights.tools.update(tool_id=368362, insight_tool_input={
        "name": "summary-tool",
        "description": "This tool uses GPT4.1 to generate a summary of the call",
        "version": 1,
        "tool_arguments": {
            "prompt": "Provide a concise, accurate summary of the conversation's key points, focusing on the user's goal and how the agent responded",
        },
        "insight_tool_definition_id": 1,
    })

    # Handle response
    print(res)
{
  "name": "<string>",
  "description": "<string>",
  "version": 123,
  "tool_arguments": "<unknown>",
  "insight_tool_definition_id": 123,
  "id": 123,
  "last_updated_by": "<string>",
  "insight_tool_definition": {
    "id": 123,
    "name": "<string>",
    "type": "<string>",
    "description": "<string>",
    "tool_parameters": "<unknown>",
    "tool_result_set": "<unknown>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Syllable-API-Key
string
header
required

Path Parameters

tool_id
integer
required

Body

application/json

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
any
required

Arguments for calling the insight tool

insight_tool_definition_id
integer
required

Internal ID for the definition used by the insight tool configuration

Response

Successful Response

Response model for 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 of insight tool

tool_arguments
any
required

Arguments for calling the insight tool

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

last_updated_by
string
required

Email of user who last updated insight tool configuration

insight_tool_definition
InsightToolDefinition · object

Insight Tool Definition

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