---
title: "Creates or Updates the Administration Settings (saveAdminSettings)"
method: POST
path: "/api/admin/settings"
tags: ["admin-controller"]
---

# Creates or Updates the Administration Settings (saveAdminSettings)

`POST /api/admin/settings`

Creates or Updates the Administration Settings. Platform generates random Administration Settings Id during settings creation. The Administration Settings Id will be present in the response. Specify the Administration Settings Id when you would like to update the Administration Settings. Referencing non-existing Administration Settings Id will cause an error.

Available for users with 'SYS_ADMIN' authority.

## Request body

- AdminSettings — A JSON value representing the Mail Settings.
  - `id` AdminSettingsId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'ADMIN_SETTINGS', required — string
  - `createdTime` integer — Timestamp of the settings creation, in milliseconds
  - `tenantId` TenantId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `key` string — The Administration Settings key, (e.g. 'general' or 'mail')
  - `jsonValue` unknown

## Response `200`

OK

- AdminSettings — A JSON value representing the Mail Settings.
  - `id` AdminSettingsId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'ADMIN_SETTINGS', required — string
  - `createdTime` integer — Timestamp of the settings creation, in milliseconds
  - `tenantId` TenantId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `key` string — The Administration Settings key, (e.g. 'general' or 'mail')
  - `jsonValue` unknown

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)