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.get_by_id(tool_id="<id>")
# Handle response
print(res)
{
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": "<any>",
"insight_tool_definition_id": 1,
"id": 1,
"insight_tool_definition": {
"id": 1,
"name": "llm_tool",
"type": "<string>",
"description": "An LLM tool evaluates a transcript with a given prompt",
"tool_parameters": "<any>",
"tool_result_set": "<any>"
},
"created_at": "2025-08-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
Get a InsightTool by Name.
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.get_by_id(tool_id="<id>")
# Handle response
print(res)
{
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": "<any>",
"insight_tool_definition_id": 1,
"id": 1,
"insight_tool_definition": {
"id": 1,
"name": "llm_tool",
"type": "<string>",
"description": "An LLM tool evaluates a transcript with a given prompt",
"tool_parameters": "<any>",
"tool_result_set": "<any>"
},
"created_at": "2025-08-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
Successful Response
Response model for an insight tool configuration.