Skip to main content
PUT
/
v1
/
flow
/
agents
/
{agent_id}
/
promote
Promote agent v1
curl --request PUT \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id}/promote \
  --header 'Authorization: <api-key>'
import requests

url = "https://flow.seekr.com/v1/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/v1/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/v1/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/v1/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/v1/flow/agents/{agent_id}/promote")
.header("Authorization", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://flow.seekr.com/v1/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>",
  "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
}
{
"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—this endpoint is only needed 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

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no '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

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
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 | null
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 July 10, 2026