Set model, temperature, token limits and escalation behaviour

The settings after the upsert (a row is created if none existed).

PUT /api/v1/agents/{id}/settings

cURL

curl --request PUT \
  --url 'https://response.stateset.com/api/v1/agents/{id}/settings' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model_name": "string",
  "model_provider": "string",
  "model_type": "string",
  "temperature": 1.5,
  "max_tokens": 1,
  "top_p": 1.5,
  "escalation_tag_name": "string",
  "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_take_over_tag": "string"
}'

200

{
  "object": "agent.settings",
  "configured": true,
  "model_name": "string",
  "model_provider": "string",
  "model_type": "string",
  "temperature": 1.5,
  "max_tokens": 1,
  "top_p": 1.5,
  "escalation_tag_name": "string",
  "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_take_over_tag": "string"
}

Path parameters

id · string (uuid) · required

The agent id.

Request body

AgentSettings

model_name · string

e.g. ‘gpt-4.1’, ‘claude-sonnet-5’.

model_provider · string

e.g. ‘openai’, ‘anthropic’.

model_type · string

temperature · number

max_tokens · integer

top_p · number

escalation_tag_name · string

escalation_team_id · string

agent_take_over_tag · string

Response

object

object · string · required

configured · boolean · required

False when no settings row exists yet for this agent (every other field is then null).

model_name · string,null · required

model_provider · string,null · required

model_type · string,null · required

temperature · number,null · required

max_tokens · integer,null · required

top_p · number,null · required

escalation_tag_name · string,null · required

escalation_team_id · string,null · required

agent_take_over_tag · string,null · required

Status codes

Code	Meaning
200	The settings after the upsert (a row is created if none existed).
400	Invalid request. issues names the offending field(s).
401	Missing, invalid, or expired API key.
403	The key lacks a required scope.
404	Not found, or not in the organization that owns the key.
429	Rate limit exceeded.

Access

Required scope	agents:write
Rate limit	30 requests per minute

cURL

curl --request PUT \
  --url 'https://response.stateset.com/api/v1/agents/{id}/settings' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model_name": "string",
  "model_provider": "string",
  "model_type": "string",
  "temperature": 1.5,
  "max_tokens": 1,
  "top_p": 1.5,
  "escalation_tag_name": "string",
  "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_take_over_tag": "string"
}'

200

{
  "object": "agent.settings",
  "configured": true,
  "model_name": "string",
  "model_provider": "string",
  "model_type": "string",
  "temperature": 1.5,
  "max_tokens": 1,
  "top_p": 1.5,
  "escalation_tag_name": "string",
  "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_take_over_tag": "string"
}