Skip to content
UltimateTeam.ai Docs

Update agent configuration

PATCH
/api/v1/agents/{role}

Update an agent’s model tier, autonomy overrides, or tools.

Authorizations

Parameters

Path Parameters

role
required

The agent role to update

string

The agent role to update

Request Body required

Request body for PATCH /agents/{role}.

Attributes: model_tier: New model tier (optional). autonomy_overrides: Updated autonomy overrides (optional). tools_enabled: Updated enabled tools list (optional). system_prompt_override: Custom system prompt (optional). agent_name: Persona name for the agent (optional). character_profile: Personality traits update (optional).

object
agent_name
Any of:
string
>= 1 characters <= 100 characters
autonomy_overrides
Any of:
object
key
additional properties
any
character_profile
Any of:

Partial update model for PATCH semantics.

All fields are optional so callers can update only the traits they want to change.

Attributes: communication_style: Tone used in all agent output. risk_tolerance: 0.0 (ultra-conservative) to 1.0 (bold). decision_temperament: How the agent approaches decisions. detail_level: Verbosity of agent responses.

object
communication_style
Any of:
string
Allowed values: formal professional casual direct warm
decision_temperament
Any of:
string
Allowed values: analytical decisive collaborative cautious
detail_level
Any of:
string
Allowed values: concise balanced thorough
risk_tolerance
Any of:
number
<= 1
model_tier
Any of:
string
<= 50 characters
system_prompt_override
Any of:
string
tools_enabled
Any of:
Array<string>

Responses

200

Successful Response

Wrapper response for PATCH /agents/{role}.

Attributes: data: The update result payload.

object
data
required

Payload returned by PATCH /agents/{role}.

Attributes: role: Agent role identifier. model_tier: Current model tier. status: Current lifecycle status. autonomy_overrides: Current autonomy overrides. agent_name: Current persona name. character_profile: Current personality traits.

object
agent_name
Any of:
string
autonomy_overrides
required
object
key
additional properties
any
character_profile
Any of:
object
key
additional properties
any
model_tier
required
string
role
required
string
status
required
string

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string