Skip to main content
GET
Get Agent By Id
Use GET /v2/flow/agents/{agent_id} instead of this deprecated endpoint.

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string
required

ID of the agent.

Response

Success

id
string
required

ID of the agent.

name
string
required

Name of the agent.

instructions
string
required

Instructions that tell the agent how to behave.

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

ID of the user who owns the agent.

team_id
string | null
required

ID of the team the agent belongs to.

created_at
string<date-time>
required

Time the agent was created, in ISO 8601 format.

updated_at
string<date-time>
required

Time the agent was last updated, in ISO 8601 format.

model_id
string | null

ID of the model the agent uses to respond.

planner_model_id
string | null

ID of the model the agent uses to plan its work.

tool_model_id
string | null

ID of the model the agent uses when it calls tools.

output
AgentOutputConfig · object | null

Optional configuration for the agent's final response. Overrides the top-level settings for response generation.

temperature
number | null

Controls the predictability of the agent's reasoning. Accepts a value from 0 to 2. Defaults to 0.6. Lower values produce more consistent results, and higher values introduce more variation.

Required range: 0 <= x <= 2
planner_temperature
number | null

Controls the predictability of the agent's planning. Lower values produce more consistent plans, and higher values introduce more variation.

Required range: 0 <= x <= 2
tools
(FileSearch · object | WebSearch · object | RunPython · object | AgentAsTool · object | MCPConnectorTool · object)[]

Tools the agent can use.

last_deployed_at
string<date-time> | null

Time the agent was last deployed, in ISO 8601 format.

active_duration
integer
default:0
Required range: x >= 0
Last modified on November 4, 2026