Skip to main content
PUT
/
v1
/
flow
/
agents
/
{agent_id}
/
promote
Promote agent
curl --request PUT \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id}/promote \
  --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
}
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

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