Update agent configuration

PATCH

/api/v1/agents/{role}

curl --request PATCH \
  --url https://api.ultimateteam.ai/api/v1/agents/example \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "agent_name": "example", "autonomy_overrides": {}, "character_profile": { "communication_style": "formal", "decision_temperament": "analytical", "detail_level": "concise", "risk_tolerance": 1 }, "model_tier": "example", "system_prompt_override": "example", "tools_enabled": [ "example" ] }'

• Production
• Local development

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

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

role

required

Role

The agent role to update

string

The agent role to update

Request Body^required

Media typeapplication/json

AgentUpdateRequest

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

string

>= 1 characters <= 100 characters

null

null

autonomy_overrides

Any of:

object

object

key

additional properties

any

null

null

character_profile

Any of:

CharacterProfileUpdate

CharacterProfileUpdate

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

string

Allowed values: formal professional casual direct warm

null

null

decision_temperament

Any of:

string

string

Allowed values: analytical decisive collaborative cautious

null

null

detail_level

Any of:

string

string

Allowed values: concise balanced thorough

null

null

risk_tolerance

Any of:

number

number

<= 1

null

null

null

null

model_tier

Any of:

string

string

<= 50 characters

null

null

system_prompt_override

Any of:

string

string

null

null

tools_enabled

Any of:

Array<string>

Array<string>

null

null

Responses

200

Successful Response

Media typeapplication/json

AgentUpdateResponse

Wrapper response for PATCH /agents/{role}.

Attributes: data: The update result payload.

object

data

required

AgentUpdateData

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

string

null

null

autonomy_overrides

required

Autonomy Overrides

object

key

additional properties

any

character_profile

Any of:

object

object

key

additional properties

any

null

null

model_tier

required

Model Tier

string

role

required

Role

string

status

required

Status

string

Example^generated

{
  "data": {
    "agent_name": "example",
    "autonomy_overrides": {},
    "character_profile": {},
    "model_tier": "example",
    "role": "example",
    "status": "example"
  }
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}