curl --request PATCH \
--url https://flow.seekr.com/v1/flow/tools/{tool_id}/diff \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "my file search tool",
"description": "contains files about ",
"config": {
"file_search_index": "my-document-index",
"top_k": 10,
"score_threshold": 0.7
}
}
'{
"before": {
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"user_id": "<string>",
"team_id": "<string>",
"status": "Active",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"type": "file_search"
},
"after": {
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"user_id": "<string>",
"team_id": "<string>",
"status": "Active",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"type": "file_search"
},
"diff": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Preview tool update
Preview the changes a patch request would make to a tool without applying them. Returns a before-and-after diff of the affected fields.
PATCH
/
v1
/
flow
/
tools
/
{tool_id}
/
diff
curl --request PATCH \
--url https://flow.seekr.com/v1/flow/tools/{tool_id}/diff \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "my file search tool",
"description": "contains files about ",
"config": {
"file_search_index": "my-document-index",
"top_k": 10,
"score_threshold": 0.7
}
}
'{
"before": {
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"user_id": "<string>",
"team_id": "<string>",
"status": "Active",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"type": "file_search"
},
"after": {
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"user_id": "<string>",
"team_id": "<string>",
"status": "Active",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"type": "file_search"
},
"diff": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Tool type cannot be changed after creation. If you include the
type field in your request, it must match the existing tool type.Authorizations
Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.
Path Parameters
ID of the tool.
Body
application/json
Name of the tool.
Maximum string length:
256Description of the tool.
Maximum string length:
32768Type of the tool.
Available options:
file_search, web_search, run_python, agent_as_tool, mcp_connector Configuration for the tool.
Response
Success
The tool before the update.
- FileSearchResponse
- RunPythonResponse
- WebSearchResponse
- AgentAsToolResponse
- MCPConnectorToolResponse
Show child attributes
Show child attributes
The tool after the update.
- FileSearchResponse
- RunPythonResponse
- WebSearchResponse
- AgentAsToolResponse
- MCPConnectorToolResponse
Show child attributes
Show child attributes
Fields the update changes.
Show child attributes
Show child attributes
Last modified on July 31, 2026
⌘I