---
title: "Update Team Settings"
method: PATCH
path: "/teams/{team_id}/settings"
tags: ["teams"]
---

# Update Team Settings

`PATCH /teams/{team_id}/settings`

Update team settings.

Requires MANAGE_BILLING permission (owner/admin). Currently exposes the
``router_enabled`` toggle for the team's auto model-router.

Args:
    team_id: Team UUID.
    settings: Validated settings payload.
    auth: Authenticated user context.

Returns:
    Success status with message.

## Path parameters

- `team_id` string, required

## Request body

- TeamSettingsUpdate — Allowed fields for PATCH /teams/{team_id}/settings.
  - `router_enabled` boolean, nullable — Enable the team's auto model-router
  - `zero_data_retention` boolean, nullable — Enable account-level Zero Data Retention: inference is not persisted and upstream gateways are told not to retain data.

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)