# Kiteworks API — settings Operations

**2 endpoints** | [Browse interactive reference](https://developer.kiteworks.com/api-reference/settings.html) | [Download spec slice](https://developer.kiteworks.com/assets/specs/settings.json)

> **Authentication required.** All requests must include a Bearer access token in the
> `Authorization` header. See [Authentication](https://developer.kiteworks.com/authentication.md) for how to
> obtain a token using OAuth 2.0 Authorization Code (PKCE) or JWT Bearer flow.

---

## GET /rest/settings/passwordPolicy

**Summary:** Get Password Policy

Returns the system's password policy settings, including minimum length, required character types, and whether the policy is enabled.
**Responses:**

| Code | Description |
|------|-------------|
| 200 | Password policy retrieved successfully. |
| 490 | Request blocked by WAF |

**Response Examples:**

**200 (PasswordPolicy):**

```json
{
  "enabled": true,
  "minLength": 8,
  "minNumeric": 1,
  "minLower": 1,
  "minUpper": 1,
  "minSpecial": 1,
  "allowBrowserAutofill": false
}
```

**Code Samples:**

**cURL:**

```shell
curl -X GET \
  "https://{instance}.kiteworks.com/rest/settings/passwordPolicy" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

**Python:**

```python
import requests

url = "https://{instance}.kiteworks.com/rest/settings/passwordPolicy"
headers = {
    "Authorization": "Bearer YOUR_TOKEN",
}
response = requests.get(url, headers=headers)
print(response.json())
```

---

## GET /rest/settings/system

**Summary:** Get system settings

Returns the system-level settings, including language, location, storage quota, and mobile number configuration as configured by the system administrator.
**Responses:**

| Code | Description |
|------|-------------|
| 200 | System settings retrieved successfully. |
| 490 | Request blocked by WAF |

**Response Examples:**

**200 (SystemSettings):**

```json
{
  "languageId": 1,
  "locationId": 1,
  "storageQuota": 10737418240,
  "mobileNumber": null,
  "mobileNumberVerified": false
}
```

**Code Samples:**

**cURL:**

```shell
curl -X GET \
  "https://{instance}.kiteworks.com/rest/settings/system" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

**Python:**

```python
import requests

url = "https://{instance}.kiteworks.com/rest/settings/system"
headers = {
    "Authorization": "Bearer YOUR_TOKEN",
}
response = requests.get(url, headers=headers)
print(response.json())
```

---
