curl --request PUT \
--url https://flow.seekr.com/v1/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": [
{
"name": "file_search",
"tool_env": {
"FILE_SEARCH_INDEX": "<string>",
"DOCUMENT_TOOL_DESC": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"id": "<string>"
}
],
"last_deployed_at": "2023-11-07T05:31:56Z",
"active_duration": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Replace agent v1
deprecated
Update an agent’s model, instructions, or tools.
PUT
/
v1
/
flow
/
agents
/
{agent_id}
/
update
curl --request PUT \
--url https://flow.seekr.com/v1/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": [
{
"name": "file_search",
"tool_env": {
"FILE_SEARCH_INDEX": "<string>",
"DOCUMENT_TOOL_DESC": "<string>",
"EMBEDDING_MODEL": "<string>",
"TOP_K": 10,
"SCORE_THRESHOLD": 0
},
"id": "<string>"
}
],
"last_deployed_at": "2023-11-07T05:31:56Z",
"active_duration": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}This endpoint is deprecated. Use
PATCH /v2/flow/agents/{agent_id} instead.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
Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.
Path Parameters
Body
application/json
Maximum string length:
256Maximum string length:
32768tools
(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 } }
Preferred way to associate tools with an agent.
Maximum string length:
32768Maximum string length:
32768Maximum string length:
32768Maximum string length:
32768Show child attributes
Show child attributes
Required range:
0 <= x <= 2Controls 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 Response
Success
Available options:
Inactive, Pending, Active, Updating, Failed 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 Show child attributes
Show child attributes
Required range:
0 <= x <= 2Required range:
0 <= x <= 2tools
(FileSearch · object | WebSearch · object | RunPython · object | AgentAsTool · object | MCPConnectorTool · object)[]
- FileSearch
- WebSearch
- RunPython
- AgentAsTool
- MCPConnectorTool
Show child attributes
Show child attributes
Required range:
x >= 0Last modified on July 31, 2026
Was this page helpful?
⌘I