Skip to main content
PATCH
/
v1
/
flow
/
agents
/
{agent_id}
curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id} \
  --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>",
  "user_id": "<string>",
  "team_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "model_id": "<string>",
  "output": {
    "instructions": "<string>",
    "model_id": "<string>",
    "temperature": 1
  },
  "temperature": 1,
  "planner_temperature": 1,
  "tools": [
    {
      "name": "<string>",
      "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
}
Active agents transition to Updating during the patch and return to Active once complete. If redeployment fails, the agent status is set to Failed. Agents in Inactive or Failed states remain in their current state after a patch. To activate an updated agent, promote it manually. The 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.

Authorizations

​
Authorization
string
header
required

Seekr API Key without 'Bearer' Prefix

Path Parameters

​
agent_id
string
required

Body

application/json
​
name
string | null
​
instructions
string | null
​
model_id
string | null
​
output
AgentOutputConfig · object
​
temperature
number | null
Required range: 0 <= x <= 2
​
tool_ids
string[] | null
​
reasoning_effort
enum<string> | null
Available options:
low,
medium,
high,
speed_optimized,
performance_optimized

Response

Successful Response

​
id
string
required
​
name
string
required
​
instructions
string
required
​
status
enum<string>
required
Available options:
Inactive,
Pending,
Active,
Updating,
Failed
​
reasoning_effort
enum<string>
required
Available options:
low,
medium,
high,
speed_optimized,
performance_optimized
​
user_id
string
required
​
team_id
string | null
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
model_id
string | null
​
output
AgentOutputConfig · object
​
temperature
number | null
Required range: 0 <= x <= 2
​
planner_temperature
number | null
Required range: 0 <= x <= 2
​
tools
(FileSearch · object | WebSearch · object | RunPython · object | AgentAsTool · object | MCPConnectorTool · object)[]
​
last_deployed_at
string<date-time> | null
​
active_duration
integer
default:0
Required range: x >= 0
Last modified on June 18, 2026