---
title: "Set Agent Prefs"
method: PATCH
path: "/api/agents/{instance_id}"
tags: ["agents"]
---

# Set Agent Prefs

`PATCH /api/agents/{instance_id}`

## Request

- Base URL: `https://api.advisorppc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.advisorppc.com/api/agents/{instance_id}`
- Auth: HTTP bearer

## Path parameters

- `instance_id` integer, required

## Headers

- `X-Tenant-Id` integer, nullable

## Request body

- PrefsIn: Every field tri-state: absent = keep, null = clear, value = set.
  - `model` string, nullable
  - `effort` string, nullable

## Response `200`

Successful Response

- PrefsOut
  - `id` integer, required
  - `model` string, nullable, required
  - `effort` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/advisorppc/apis/advisorppc-api.md) · [All operations](https://skmtc.dev/advisorppc/apis/advisorppc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/advisorppc/apis/advisorppc-api/revisions/3441bd729e0c?raw)