---
title: "Update Active Team Settings"
method: PATCH
path: "/api/teams/me/settings"
---

# Update Active Team Settings

`PATCH /api/teams/me/settings`

## Request

- Base URL: `https://api.gethesperai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gethesperai.com/api/teams/me/settings`
- Auth: none declared

Replace the active team's settings (insurance verticals + agent roster).

Scoped to the active team (X-Team-Id), so a founder in god mode writes the
impersonated team's settings — exactly the team whose settings the UI shows.
member+ can write; viewers are read-only.

## Headers

- `X-Team-Id` string, nullable

## Request body

- TeamSettingsRequest: Per-team config: active verticals + per-claim agent roster. Replace-semantics: the whole blob is overwritten on PATCH. The frontend owns the agent roster definitions and fills defaults, so we only validate the shape and the one hard invariant (at least one valid vertical).
  - `active_insurance_types` string[]
  - `enabled_agents` object
  - `outreach_cadence` object, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator.md) - [All operations](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/llms.txt) - [OpenAPI document](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/revisions/1a031ee6acf1?raw)