---
title: "Changes to create setting"
method: POST
path: "/apps/{app_id}/settings"
---

# Changes to create setting

`POST /apps/{app_id}/settings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 23 revisions.

- **2026-07-24** `1dc1e5b8c6eb`: 1 breaking, 2 info
- **2026-01-22** `9f13a846724c`: 2 breaking, 2 warning, 4 info
- **2025-11-14** `a0af32b45330`: 1 info

## Changes

- **2026-07-24** `1dc1e5b8c6eb`: 1 breaking, 2 info
  - the response property `sensitive_settings` became optional for the status `201`
  - added the new optional `header` request parameter `Prefer`
  - added the new optional `query` request parameter `no_embed`
- **2026-01-22** `9f13a846724c`: 2 breaking, 2 warning, 4 info
  - removed the required property `keys` from the response with the `201` status
  - removed the required property `sensitive_keys` from the response with the `201` status
  - removed the request property `keys`
  - removed the request property `sensitive_keys`
  - added the new optional request property `sensitive_settings`
  - added the new optional request property `settings`
  - added the required property `sensitive_settings` to the response with the `201` status
  - added the required property `settings` to the response with the `201` status
- **2025-11-14** `a0af32b45330`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/aptible/apis/aptible-api-v1/docs/apps/:app_id/settings/post.md) - [API](https://skmtc.dev/aptible/apis/aptible-api-v1.md) - [Page](https://skmtc.dev/aptible/apis/aptible-api-v1/changes/apps/:app_id/settings/post)