---
title: "Enable ADL device location settings"
method: POST
path: "/v1/locate/devices/settings"
tags: ["Device Locator"]
---

# Enable ADL device location settings

`POST /v1/locate/devices/settings`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/locate/devices/settings`
- Auth: HTTP bearer

Enables location-based settings (ADL) for a set of devices.

## Request body

- Postschema5: Enables location-based settings for a set of devices
  - `deviceIds` string[], required: Set of device ICCID to apply the setting to
  - `details` Postschema5Details, required: The setting configuration
    - `frequency` integer, required

## Response `200`

OK

- PostResponseschema4: Response body for enabling location-based settings for devices
  - `changedDeviceIds` string[], required: Array of device ICCIDs whose state changed

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `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)
