curl --request PATCH \
--url https://flow.seekr.com/v1/flow/agents/{agent_id}/diff \
--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"
]
}
'{
"before": {
"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
},
"after": {
"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
},
"diff": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Preview agent update v1
deprecated
Preview the changes a patch request would make to an agent without applying them. Returns a before-and-after diff of the affected fields.
PATCH
/
v1
/
flow
/
agents
/
{agent_id}
/
diff
curl --request PATCH \
--url https://flow.seekr.com/v1/flow/agents/{agent_id}/diff \
--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"
]
}
'{
"before": {
"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
},
"after": {
"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
},
"diff": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Use
PATCH /v2/flow/agents/{agent_id}/diff instead of this deprecated endpoint.Authorizations
Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.
Path Parameters
ID of the agent.
Body
application/json
New name for the agent.
Maximum string length:
256Instructions that tell the agent how to behave.
Maximum string length:
32768ID of the model the agent uses to respond.
Maximum string length:
32768ID of the model the agent uses to plan its work.
Maximum string length:
32768ID of the model the agent uses when it calls tools.
Maximum string length:
32768Optional configuration for the agent's final response. Overrides the top-level settings for response generation.
Show child attributes
Show child attributes
Controls the predictability of the agent's reasoning. Accepts a value from 0 to 2. Defaults to 0.6. Lower values produce more consistent results, and higher values introduce more variation.
Required range:
0 <= x <= 2IDs of the tools the agent can use.
Maximum string length:
32768Controls how much reasoning the agent uses when it works through a request.
Available options:
low, medium, high, speed_optimized, performance_optimized Last modified on November 4, 2026
⌘I