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": {}
}
]
}This endpoint is deprecated. Use
PATCH /v1/flow/tools/{tool_id} instead.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
Body
application/json
- CreateFileSearch
- CreateRunPython
- CreateWebSearch
- CreateAgentAsTool
- CreateMCPConnectorTool
Response
Success
- FileSearchResponse
- RunPythonResponse
- WebSearchResponse
- AgentAsToolResponse
- MCPConnectorToolResponse
Show child attributes
Show child attributes
Available options:
Active, Inactive, Deprecated, Pending_authorization, Failed Allowed value:
"file_search"Last modified on July 31, 2026
Was this page helpful?
⌘I