Skip to main content
PUT
Promote
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

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Path Parameters

agent_id
string
required

Response

Success

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
planner_model_id
string | null
tool_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 | 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.

last_deployed_at
string<date-time> | null
active_duration
integer
default:0
Required range: x >= 0
Last modified on July 31, 2026