Skip to main content
PUT
/
v1
/
flow
/
agents
/
{agent_id}
/
demote
Demote agent
curl --request PUT \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id}/demote \
  --header 'Authorization: <api-key>'
{
  "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
}
Move an agent to an inactive state. The agent’s configuration is retained but it will not handle inference requests. When demoting an agent that has other agents linked as tools, the linked agents are not automatically demoted — each must be demoted individually if needed. An agent that is linked as a tool to another agent cannot be demoted while that relationship is active. Demote the parent agent first, or unlink the agent-as-tool.

Authorizations

​
Authorization
string
header
required

Seekr API Key without 'Bearer' Prefix

Path Parameters

​
agent_id
string
required

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