curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/update \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "My Agent",
"instructions": "You are a helpful assistant that can search files, browse the web, and run Python code.",
"model_id": "deployment-123",
"temperature": 0.4,
"reasoning_effort": "medium",
"tool_ids": [
"tool-123",
"tool-456"
]
}
'{
"id": "<string>",
"name": "<string>",
"instructions": "<string>",
"status": "Inactive",
"reasoning_effort": "low",
"user_id": "<string>",
"team_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"model_id": "<string>",
"planner_model_id": "<string>",
"tool_model_id": "<string>",
"output": {
"frequency": "always",
"instructions": "<string>",
"model_id": "<string>",
"temperature": 1
},
"temperature": 1,
"planner_temperature": 1,
"tools": [
{
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"description": "<string>",
"type": "file_search"
}
],
"last_deployed_at": "2023-11-07T05:31:56Z",
"active_duration": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Replace agent
deprecated
Update an agent’s model, instructions, or tools.
PUT
/
v2
/
flow
/
agents
/
{agent_id}
/
update
curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/update \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "My Agent",
"instructions": "You are a helpful assistant that can search files, browse the web, and run Python code.",
"model_id": "deployment-123",
"temperature": 0.4,
"reasoning_effort": "medium",
"tool_ids": [
"tool-123",
"tool-456"
]
}
'{
"id": "<string>",
"name": "<string>",
"instructions": "<string>",
"status": "Inactive",
"reasoning_effort": "low",
"user_id": "<string>",
"team_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"model_id": "<string>",
"planner_model_id": "<string>",
"tool_model_id": "<string>",
"output": {
"frequency": "always",
"instructions": "<string>",
"model_id": "<string>",
"temperature": 1
},
"temperature": 1,
"planner_temperature": 1,
"tools": [
{
"id": "<string>",
"name": "<string>",
"config": {
"FILE_SEARCH_INDEX": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"description": "<string>",
"type": "file_search"
}
],
"last_deployed_at": "2023-11-07T05:31:56Z",
"active_duration": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Use
PATCH /v2/flow/agents/{agent_id} instead of this deprecated endpoint.tool_ids parameter accepts IDs for any tool type, including agent-as-tools. Agent-as-tools must be created before adding them to tool_ids. See Agent as tool for setup instructions.
When an active supervisor agent is updated to include new sub-agents, the supervisor transitions to Updating while the sub-agents are promoted, then returns to Active when ready.Authorizations
Body
application/json
tools
(CreateFileSearch · object | CreateWebSearch · object | CreateRunPython · object)[] | null
deprecated
Deprecated. Use tool_ids instead.
- CreateFileSearch
- CreateWebSearch
- CreateRunPython
Show child attributes
Show child attributes
Example:
{
"name": "file_search",
"tool_env": {
"document_tool_desc": "Search through uploaded documents",
"file_search_index": "my-document-index",
"score_threshold": 0.7,
"top_k": 10
}
}
Response
Success
Controls how much reasoning the agent uses when working through a request. Accepts low, medium, or high, where higher levels produce more thorough reasoning. The speed_optimized and performance_optimized values are only supported for backward compatibility. speed_optimized maps to low, and performance_optimized maps to high.
Available options:
low, medium, high, speed_optimized, performance_optimized tools
(FileSearch · object | RunPython · object | WebSearch · object | AgentAsTool · object | MCPConnectorTool · object)[]
The tools available to the agent. Each item configures one tool and must match one of the supported tool types: file search, run Python, web search, agent-as-tool, or MCP connector.
Configuration for the file search tool: semantic search and retrieval across the agent's vector databases.
- FileSearch
- RunPython
- WebSearch
- AgentAsTool
- MCPConnectorTool
Show child attributes
Show child attributes
Last modified on November 4, 2026
⌘I