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

# Update Settings

`PATCH /settings`

Update the settings

## Request body

- object

## Response `200`

Successful request

- object
  - `data` Settings
    - `id` integer — Unique identifier for the setting.
    - `project_name` string — The name of the project.
    - `project_url` string, nullable — The url of the project.
    - `project_color` string, nullable — The brand color of the project.
    - `project_logo` string, nullable — The logo of the project.
    - `public_foreground` string, nullable — The foreground of the project.
    - `public_background` object, nullable — The background of the project.
      - `id` string
      - `type` string
    - `public_note` string, nullable — Note rendered on the public pages of the app.
    - `auth_login_attempts` integer — Allowed authentication login attempts before the user's status is set to blocked.
    - `auth_password_policy` string, nullable — Authentication password policy.
    - `storage_asset_transform` 'all' | 'none' | 'presets', nullable — What transformations are allowed in the assets endpoint.
    - `storage_asset_presets` object[], nullable — Array of allowed
      - `key` string — Key for the asset. Used in the assets endpoint.
      - `fit` 'cover' | 'contain' | 'inside' | 'outside' — Whether to crop the thumbnail to match the size, or maintain the aspect ratio.
      - `width` integer — Width of the thumbnail.
      - `height` integer — Height of the thumbnail.
      - `withoutEnlargement` boolean — No image upscale
      - `quality` integer — Quality of the compression used.
      - `format` '' | 'jpeg' | 'png' | 'webp' | 'tiff' | 'avif' — Reformat output image
      - `transforms` object[], nullable — Additional transformations to apply
        - `method` string — The Sharp method name
        - `arguments` object[], nullable — A list of arguments to pass to the Sharp method
          - `argument` string — A JSON representation of the argument value
    - `custom_css` string, nullable
    - `storage_default_folder` string, uuid — Default folder to place files
    - `basemaps` unknown
    - `mapbox_key` string, nullable
    - `module_bar` unknown
    - `project_descriptor` string, nullable
    - `default_language` string
    - `custom_aspect_ratios` unknown
    - `public_favicon` union — $t:field_options.directus_settings.project_favicon_note
      - string, uuid
      - Files
        - `id` string — Unique identifier for the file.
        - `storage` string — Where the file is stored. Either `local` for the local filesystem or the name of the storage adapter (for example `s3`).
        - `filename_disk` string — Name of the file on disk. By default, Directus uses a random hash for the filename.
        - `filename_download` string — How you want to the file to be named when it's being downloaded.
        - `title` string — Title for the file. Is extracted from the filename on upload, but can be edited by the user.
        - `type` string — MIME type of the file.
        - `folder` union — Virtual folder where this file resides in.
          - string
          - Folders
            - `id` string — Unique identifier for the folder.
            - `name` string — Name of the folder.
            - `parent` union — Unique identifier of the parent folder. This allows for nested folders.
              - …
        - `uploaded_by` union — Who uploaded the file.
          - string
          - Users
            - `id` string — Unique identifier for the user.
            - `first_name` string — First name of the user.
            - `last_name` string — Last name of the user.
            - `email` string, email — Unique email address for the user.
            - `password` string — Password of the user.
            - `location` string, nullable — The user's location.
            - `title` string, nullable — The user's title.
            - `description` string, nullable — The user's description.
            - `tags` string[], nullable — The user's tags.
            - `avatar` union — The user's avatar.
              - …
            - `language` string — The user's language used in Directus.
            - `tfa_secret` string, nullable — The 2FA secret string that's used to generate one time passwords.
            - `status` 'active' | 'invited' | 'draft' | 'suspended' | 'deleted' — Status of the user.
            - `role` union — Unique identifier of the role of this user.
              - …
            - `token` string, nullable — Static token for the user.
            - `last_access` string, date-time, nullable — When this user used the API last.
            - `last_page` string, nullable — Last page that the user was on.
            - `provider` string
            - `external_identifier` string, nullable
            - `auth_data` unknown
            - `email_notifications` boolean, nullable
            - `appearance` string, nullable
            - `theme_dark` string, nullable
            - `theme_light` string, nullable
            - `theme_light_overrides` unknown
            - `theme_dark_overrides` unknown
            - `text_direction` string
            - `policies` unknown
        - `created_on` string, date-time — When the file was created.
        - `modified_by` union
          - string, uuid
          - Users
            - `id` string — Unique identifier for the user.
            - `first_name` string — First name of the user.
            - `last_name` string — Last name of the user.
            - `email` string, email — Unique email address for the user.
            - `password` string — Password of the user.
            - `location` string, nullable — The user's location.
            - `title` string, nullable — The user's title.
            - `description` string, nullable — The user's description.
            - `tags` string[], nullable — The user's tags.
            - `avatar` union — The user's avatar.
              - …
            - `language` string — The user's language used in Directus.
            - `tfa_secret` string, nullable — The 2FA secret string that's used to generate one time passwords.
            - `status` 'active' | 'invited' | 'draft' | 'suspended' | 'deleted' — Status of the user.
            - `role` union — Unique identifier of the role of this user.
              - …
            - `token` string, nullable — Static token for the user.
            - `last_access` string, date-time, nullable — When this user used the API last.
            - `last_page` string, nullable — Last page that the user was on.
            - `provider` string
            - `external_identifier` string, nullable
            - `auth_data` unknown
            - `email_notifications` boolean, nullable
            - `appearance` string, nullable
            - `theme_dark` string, nullable
            - `theme_light` string, nullable
            - `theme_light_overrides` unknown
            - `theme_dark_overrides` unknown
            - `text_direction` string
            - `policies` unknown
        - `modified_on` string, date-time
        - `charset` string, nullable — Character set of the file.
        - `filesize` integer — Size of the file in bytes.
        - `width` integer, nullable — Width of the file in pixels. Only applies to images.
        - `height` integer, nullable — Height of the file in pixels. Only applies to images.
        - `duration` integer, nullable — Duration of the file in seconds. Only applies to audio and video.
        - `embed` string, nullable — Where the file was embedded from.
        - `description` string, nullable — Description for the file.
        - `location` string, nullable — Where the file was created. Is automatically populated based on Exif data for images.
        - `tags` string[], nullable — Tags for the file. Is automatically populated based on Exif data for images.
        - `metadata` object, nullable — IPTC, Exif, and ICC metadata extracted from file
        - `focal_point_x` integer, nullable
        - `focal_point_y` integer, nullable
        - `tus_id` string, nullable
        - `tus_data` unknown
        - `uploaded_on` string, date-time — When the file was last uploaded/replaced.
    - `default_appearance` string
    - `default_theme_light` string, nullable
    - `theme_light_overrides` unknown
    - `default_theme_dark` string, nullable
    - `theme_dark_overrides` unknown
    - `report_error_url` string, nullable
    - `report_bug_url` string, nullable
    - `report_feature_url` string, nullable
    - `public_registration` boolean — $t:fields.directus_settings.public_registration_note
    - `public_registration_verify_email` boolean — $t:fields.directus_settings.public_registration_verify_email_note
    - `public_registration_role` union — $t:fields.directus_settings.public_registration_role_note
      - string, uuid
      - Roles
        - `id` string — Unique identifier for the role.
        - `name` string — Name of the role.
        - `icon` string — The role's icon.
        - `description` string, nullable — Description of the role.
        - `parent` union — $t:field_options.directus_roles.parent_note
          - string, uuid
          - Roles — recursive
        - `children` union[], nullable — $t:field_options.directus_roles.children_note
          - union
            - string, uuid
            - Roles — recursive
        - `policies` unknown
        - `users` union[], nullable
          - union
            - string, uuid
            - Users
              - …
    - `public_registration_email_filter` unknown
    - `visual_editor_urls` unknown
    - `project_id` string, nullable
    - `mcp_enabled` boolean — $t:fields.directus_settings.mcp_enabled_note
    - `mcp_allow_deletes` boolean — $t:fields.directus_settings.mcp_allow_deletes_note
    - `mcp_prompts_collection` string, nullable — $t:fields.directus_settings.mcp_prompts_collection_note
    - `mcp_system_prompt_enabled` boolean — $t:fields.directus_settings.mcp_system_prompt_enabled_note
    - `mcp_system_prompt` string, nullable — $t:fields.directus_settings.mcp_system_prompt_note
    - `project_owner` string, nullable
    - `project_usage` string, nullable
    - `org_name` string, nullable
    - `product_updates` boolean, nullable
    - `project_status` string, nullable
    - `ai_openai_api_key` string, nullable
    - `ai_anthropic_api_key` string, nullable
    - `ai_system_prompt` string, nullable — $t:fields.directus_settings.ai_system_prompt_note

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

## Changes

- **2026-07-17** `4a0ccd34700e` — 1 warning, 8 info
  - removed the optional property `data/accepted_terms` from the response with the `200` status
  - added the optional property `data/ai_anthropic_api_key` to the response with the `200` status
  - added the optional property `data/ai_openai_api_key` to the response with the `200` status
  - added the optional property `data/ai_system_prompt` to the response with the `200` status
  - …5 more
- **2025-09-24** `c1e11fdf9e52` — 5 info
  - added the optional property `data/mcp_allow_deletes` to the response with the `200` status
  - added the optional property `data/mcp_enabled` to the response with the `200` status
  - added the optional property `data/mcp_prompts_collection` to the response with the `200` status
  - added the optional property `data/mcp_system_prompt` to the response with the `200` status
  - …1 more
- **2025-09-18** `4c523c5346af` — 13 warning, 1 info
  - removed the optional property `data/ai_anthropic_api_key` from the response with the `200` status
  - removed the optional property `data/ai_openai_api_key` from the response with the `200` status
  - removed the optional property `data/ai_system_prompt` from the response with the `200` status
  - removed the optional property `data/mcp_allow_deletes` from the response with the `200` status
  - …10 more

[Change history](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/changes/settings/patch.md)

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)