---
title: "POST /user/settings"
method: POST
path: "/user/settings"
tags: ["settings"]
---

# POST /user/settings

`POST /user/settings`

Adds user settings

## Request body

- UserSetting
  - `category` string
  - `data` DashboardElement
    - `cssclass` string
    - `href` string
    - `id` string
    - `name` string
    - `owner` string
    - `param` string
    - `shared` boolean
    - `type` integer
    - `weight` number, double
  - `guid` string
  - `id` integer
  - `param` string
  - `partid` integer
  - `username` string

## Response `201`

UserSettingCreateSuccessfulResponse

- UserSettingCreateSuccessfulResponse
  - `data` string
  - `message` string

## Other responses

- `400` — FailureResponse

## Changes

- **2021-10-13** `ee397eaefd08` — 7 info
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `in` was added to the API
  - the endpoint scheme security `name` was added to the API
  - the endpoint scheme security `type` was added to the API
  - …3 more
- **2020-04-01** `8739183b4c43` — 1 info
  - endpoint added
- **2020-01-12** `52987c8da72a` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/sipcapture/apis/homer-app/changes/user/settings/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/ee397eaefd08/schema)