curl --request PUT \
--url https://flow.seekr.com/v1/flow/tools/{tool_id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "my file search tool",
"description": "contains files about ",
"type": "file_search",
"config": {
"file_search_index": "my-document-index",
"top_k": 10,
"score_threshold": 0.7
}
}
'{
"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"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Replace tool
deprecated
Update an existing tool.
PUT
/
v1
/
flow
/
tools
/
{tool_id}
curl --request PUT \
--url https://flow.seekr.com/v1/flow/tools/{tool_id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "my file search tool",
"description": "contains files about ",
"type": "file_search",
"config": {
"file_search_index": "my-document-index",
"top_k": 10,
"score_threshold": 0.7
}
}
'{
"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"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Use
PATCH /v1/flow/tools/{tool_id} instead of this deprecated endpoint.MCP connector
You can update an MCP connector tool’sname and description. The server URL and authentication credentials (config.URL, config.CLIENT_ID, config.CLIENT_SECRET) cannot be updated. To use a different server or credentials, delete the tool and create a new one, then update your agent’s tool_ids. MCP connector tools cannot be duplicated.
Agent as tool
When updating an agent-as-tool, theconfig.agent_id must match the original sub-agent. You cannot swap the underlying sub-agent—if you need a different one, delete this tool and create a new one.
For SDK examples and full constraints, see Agent as tool.Authorizations
Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.
Path Parameters
ID of the tool.
Body
application/json
- CreateFileSearch
- CreateRunPython
- CreateWebSearch
- CreateAgentAsTool
- CreateMCPConnectorTool
Response
Success
- FileSearchResponse
- RunPythonResponse
- WebSearchResponse
- AgentAsToolResponse
- MCPConnectorToolResponse
ID of the tool.
Name of the tool.
Show child attributes
Show child attributes
ID of the user who owns the tool.
ID of the team the tool belongs to.
Available options:
Active, Inactive, Deprecated, Pending_authorization, Failed Version number of the tool.
Time the tool was created, in ISO 8601 format.
Time the tool was last updated, in ISO 8601 format.
Description of the tool.
Allowed value:
"file_search"Last modified on November 4, 2026
⌘I