---
title: "Update agent preferences (partial update)"
method: PUT
path: "/api/agent/settings"
tags: ["Settings"]
---

# Update agent preferences (partial update)

`PUT /api/agent/settings`

## Request body

- UpdateAgentSettingsRequest — All fields optional — partial update
  - `defaultPlatforms` string[]
  - `imageStylePreset` 'minimal' | 'tech' | 'bold'
  - `contentTone` 'professional' | 'casual' | 'bold'
  - `publishSchedule` PublishSchedule
    - `postsPerDay` integer, required
    - `slots` string[]
  - `targetTimezone` string
  - `trustLevel` 'ask_all' | 'show_preview' | 'autopilot'
  - `scanSources` string[]

## Response `200`

Updated settings

- AgentSettingsResponse
  - `defaultPlatforms` string[], required
  - `imageStylePreset` 'minimal' | 'tech' | 'bold', required
  - `contentTone` 'professional' | 'casual' | 'bold', required
  - `publishSchedule` PublishSchedule, required
    - `postsPerDay` integer, required
    - `slots` string[]
  - `targetTimezone` string, required
  - `trustLevel` 'ask_all' | 'show_preview' | 'autopilot', required
  - `scanSources` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `429` — Rate limit exceeded
- `500` — Internal server error

## Changes

> 28 revisions in range; 1 could not be searched.

- **2026-03-01** `2df2182b5901` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/citedy/apis/citedy-agent-api/changes/api/agent/settings/put.md)

---

[API](https://skmtc.dev/citedy/apis/citedy-agent-api.md) · [All operations](https://skmtc.dev/citedy/apis/citedy-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citedy/citedy-agent-api/revisions/b5785d3fe446/schema)