---
title: "PATCH /admin/settings/"
method: PATCH
path: "/admin/settings/"
tags: ["admin"]
---

# PATCH /admin/settings/

`PATCH /admin/settings/`

Settings view

## Request body

- PatchedSettingsRequest — Settings Serializer
  - `avatars` string — Configure how authentik should show avatars for users.
  - `base_url` string, uri — Configure the base URL under which this authentik instance is reachable, e.g. https://authentik.company
  - `default_user_change_name` boolean — Enable the ability for users to change their name.
  - `default_user_change_email` boolean — Enable the ability for users to change their email address.
  - `default_user_change_username` boolean — Enable the ability for users to change their username.
  - `event_retention` string — Events will be deleted after this duration.(Format: weeks=3;days=2;hours=3,seconds=2).
  - `reputation_lower_limit` integer — Reputation cannot decrease lower than this value. Zero or negative.
  - `reputation_upper_limit` integer — Reputation cannot increase higher than this value. Zero or positive.
  - `footer_links` unknown
  - `gdpr_compliance` boolean — When enabled, all the events caused by a user will be deleted upon the user's deletion.
  - `impersonation` boolean — Globally enable/disable impersonation.
  - `impersonation_require_reason` boolean — Require administrators to provide a reason for impersonating a user.
  - `default_token_duration` string — Default token duration
  - `default_token_length` integer — Default token length
  - `pagination_default_page_size` integer — Default page size for API responses, if no size was requested.
  - `pagination_max_page_size` integer — Maximum page size
  - `flags` object
    - `core_default_app_access` boolean, required — Applications with no policies bound can be accessed by any user.
    - `enterprise_audit_include_expanded_diff` boolean, required — Include additional information in audit logs, may incur a performance penalty.
    - `flows_continuous_login` boolean, required — Upon successful authentication, re-start authentication in other open tabs.

## Response `200`

- Settings — Settings Serializer
  - `avatars` string — Configure how authentik should show avatars for users.
  - `base_url` string, uri — Configure the base URL under which this authentik instance is reachable, e.g. https://authentik.company
  - `default_user_change_name` boolean — Enable the ability for users to change their name.
  - `default_user_change_email` boolean — Enable the ability for users to change their email address.
  - `default_user_change_username` boolean — Enable the ability for users to change their username.
  - `event_retention` string — Events will be deleted after this duration.(Format: weeks=3;days=2;hours=3,seconds=2).
  - `reputation_lower_limit` integer — Reputation cannot decrease lower than this value. Zero or negative.
  - `reputation_upper_limit` integer — Reputation cannot increase higher than this value. Zero or positive.
  - `footer_links` unknown
  - `gdpr_compliance` boolean — When enabled, all the events caused by a user will be deleted upon the user's deletion.
  - `impersonation` boolean — Globally enable/disable impersonation.
  - `impersonation_require_reason` boolean — Require administrators to provide a reason for impersonating a user.
  - `default_token_duration` string — Default token duration
  - `default_token_length` integer — Default token length
  - `pagination_default_page_size` integer — Default page size for API responses, if no size was requested.
  - `pagination_max_page_size` integer — Maximum page size
  - `flags` object, required
    - `core_default_app_access` boolean, required — Applications with no policies bound can be accessed by any user.
    - `enterprise_audit_include_expanded_diff` boolean, required — Include additional information in audit logs, may incur a performance penalty.
    - `flows_continuous_login` boolean, required — Upon successful authentication, re-start authentication in other open tabs.

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)