Promote
curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/promote \
--header 'Authorization: <api-key>'import requests
url = "https://flow.seekr.com/v2/flow/agents/{agent_id}/promote"
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}/promote', 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}/promote",
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}/promote"
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}/promote")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://flow.seekr.com/v2/flow/agents/{agent_id}/promote")
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": {}
}
]
}Promote agent
Promote an agent to active status so it can serve requests.
PUT
/
v2
/
flow
/
agents
/
{agent_id}
/
promote
Promote
curl --request PUT \
--url https://flow.seekr.com/v2/flow/agents/{agent_id}/promote \
--header 'Authorization: <api-key>'import requests
url = "https://flow.seekr.com/v2/flow/agents/{agent_id}/promote"
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}/promote', 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}/promote",
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}/promote"
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}/promote")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://flow.seekr.com/v2/flow/agents/{agent_id}/promote")
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": {}
}
]
}Activate an agent so it can handle inference requests. Agents are automatically promoted on creation. You only need this endpoint after an agent has been demoted.
When promoting an agent that has sub-agents linked as tools, SeekrFlow automatically promotes the sub-agents first. The supervisor remains in
Pending state until all sub-agents are ready.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