---
title: "Patch Settings"
method: PATCH
path: "/v1/settings/1nceos/{name}"
tags: ["Settings"]
---

# Patch Settings

`PATCH /v1/settings/1nceos/{name}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/settings/1nceos/{name}`
- Auth: HTTP bearer

Enables or disables different settings for the 1NCE OS integration of a customer.

Disclaimer: I acknowledge that activating the location feature involves processing nearby Cell Tower data by 1NCE. 1NCE processing of data is done anonymously. I understand that if the use of the service by me makes it linkable to individuals, additional data related responsibilities may apply. As per 1NCE General Terms and Conditions (GTC), I am solely responsible for complying with Data Protection laws and regulations and obtaining necessary consents.

## Path parameters

- `name` string, required

## Request body

- Patchschema2: Patch options for setting request.
  - `state` 'ENABLED' | 'DISABLED', required: State to set for setting.
  - `readAndAcceptedDisclaimer` boolean: Has the disclaimer for enabling CELL_TOWER_LOCATION setting been read and accepted.

## Response `200`

An object describing a setting

- PatchSettingResponseschema: Response to configuring a setting.
  - `customerId` string, required: Internal customer identifier.
  - `name` string, required: Name of setting.
  - `state` 'ENABLED' | 'DISABLED', required: State of the setting.
  - `details` PatchSettingResponseschemaDetails: Patched details of the setting. Contains only the field(s) included in the request body (e.g. mode or frequency).
    - `frequency` integer: Global cell-tower resolution frequency in minutes (60-1440 inclusive).

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)