Demote
curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/demote \
--header 'Authorization: <api-key>'import requests
url = "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote"
headers = {"Authorization": "<api-key>"}
response = requests.put(url, headers=headers)
print(response.text)const options = {method: 'PUT', headers: {Authorization: '<api-key>'}};
fetch('https://flow.seekr.com/v2/flow/agents/{agent_id}/demote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://flow.seekr.com/v2/flow/agents/{agent_id}/demote")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://flow.seekr.com/v2/flow/agents/{agent_id}/demote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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": {}
}
]
}Demote agent
Demote an agent to inactive status.
PUT
/
v2
/
flow
/
agents
/
{agent_id}
/
demote
Demote
curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/demote \
--header 'Authorization: <api-key>'import requests
url = "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote"
headers = {"Authorization": "<api-key>"}
response = requests.put(url, headers=headers)
print(response.text)const options = {method: 'PUT', headers: {Authorization: '<api-key>'}};
fetch('https://flow.seekr.com/v2/flow/agents/{agent_id}/demote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://flow.seekr.com/v2/flow/agents/{agent_id}/demote"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://flow.seekr.com/v2/flow/agents/{agent_id}/demote")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://flow.seekr.com/v2/flow/agents/{agent_id}/demote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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": {}
}
]
}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. Demote each one 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
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 July 31, 2026
⌘I