---
title: "Update team settings"
method: PATCH
path: "/v4/settings"
tags: ["v4", "Settings"]
---

# Update team settings

`PATCH /v4/settings`

## Request body

- UpdateTeamSettingsRequest
  - `timezone` string, nullable — Team timezone (e.g. America/New_York)
  - `global_fi_memory` string, nullable — Global Fi memory content (max 25,000 chars)
  - `ssoRequired` boolean, nullable — Whether SSO login is required for the team (disables email/password sign-in)

## Response `200`

Success

- SuccessResponseTeamSchema
  - `success` true, required — Flag for it request was successful
  - `data` TeamSchema, required
    - `id` union — Team ID
      - string, uuid
      - string
    - `created_at` string, date-time — User created at
    - `updated_at` string, date-time — User updated at
    - `details` TeamDetailsSchema
      - `onboarding` TeamDetailsOnboardingSchema
        - `has_added_doc` boolean
        - `has_added_integration` boolean
        - `has_added_team_member` boolean
      - `timezone` string — Team timezone for date calculations (e.g. America/New_York)
      - `ssoEnabled` boolean — Whether SSO is enabled for the team
      - `ssoRequired` boolean — Whether SSO is required for the team
    - `domain` string, required — Team domain
    - `plan` 'free' | 'trial' | 'standard' | 'enterprise' — Team plan
    - `trial_end_at` string, date-time, nullable — Trial end timestamp
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)