---
title: "Partially update company settings"
method: PATCH
path: "/v1/enterprise/{enterprise_id}/"
tags: ["esper_cloud_api_Company Settings"]
---

# Partially update company settings

`PATCH /v1/enterprise/{enterprise_id}/`

Partially updates the company settings for the specified enterprise, returning the full updated record.
Supply only the fields you want to change — all omitted fields retain their current values.

**About Partial Update Company Settings**

This endpoint (formerly "Partial Update Enterprise Information") applies sparse updates to the EnterpriseV1 record using the EnterpriseUpdateV1 schema. All fields in the request body are optional; only those included will be changed. Read-only fields (id, short_code, created_on, updated_on, emm) cannot be modified and should be omitted from the request body. The response returns the complete updated EnterpriseV1 object. Call GET /v1/enterprise/{enterprise_id}/ first to retrieve current values before making changes.

**Key Fields**

enterprise_id (path, required) — UUID of the enterprise to update

name (optional) — Display name of the enterprise (max 255 chars)

registered_name (optional) — Formal legal name of the organization

registered_address (optional) — Registered business address

location (optional) — City, state, and country

zipcode (optional) — Postal code for the enterprise location (max 8 chars)

contact_person (optional, nullable) — Primary point-of-contact name

contact_number (optional, nullable) — Contact phone number

contact_email (optional) — Contact email address

wifi_lte_toggle_flag (optional) — Toggles data saver mode; only effective if the feature is enabled for the enterprise

**Common Use Cases**

Updating enterprise contact details after an organizational change

Correcting the registered name or address on file

Toggling wifi_lte_toggle_flag when enabling or disabling data saver mode

**Best Practices**

Call GET /v1/enterprise/{enterprise_id}/ first to confirm current values before issuing a PATCH

Include only the fields you intend to change; PATCH is safe to use for single-field updates

Do not include id, short_code, created_on, updated_on, or emm in the request body — they are read-only and will be ignored or may cause errors

Verify the update took effect by inspecting the returned EnterpriseV1 object in the response

**Workflow**

Call GET /v1/enterprise/{enterprise_id}/ to retrieve the current enterprise record

Construct a partial payload containing only the fields to update

Call PATCH /v1/enterprise/{enterprise_id}/ with the payload

Confirm the changes in the returned EnterpriseV1 response object

## Path parameters

- `enterprise_id` string, uuid, required

## Response `200`

successful operation

- EsperCloudApiEnterpriseV1
  - `id` string, uuid, required — Id of the enterprise
  - `name` string, required — Name of the enterprise
  - `short_code` string, required — A short 10-char representation of the enterprise, separated by hyphens. Field is optional, as system will auto-generate a value if none is provided.
  - `registered_name` string — Registered Name of the enterprise
  - `registered_address` string — Registered address of the enterprise.
  - `location` string — City, State, Country location of the enterprise
  - `zipcode` string — Zip code of enterprise location
  - `contact_person` string, nullable — Person who is the point of contact for the enterprise
  - `contact_number` string, nullable — Contact number of the enterprise
  - `contact_email` string, email — Contact email address of the enterprise
  - `wifi_lte_toggle_flag` boolean — Will only be available if feature is enabled
  - `emm` object, nullable — This field will have details about emm enrollment if the enterprise is emm enrolled
    - `google_enterprise_id` string
  - `created_on` string, date-time — Date and time of when this resource was created
  - `updated_on` string, date-time — Date and time of when this resource was updated

## Other responses

- `400` — Invalid request.
- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)