v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Company Settings

Partially update company settings

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

patch/v1/enterprise/{enterprise_id}/

Path parameters

enterprise_idstring uuid required

A UUID string identifying this enterprise.

Response

successful operation

idstring uuid required

Id of the enterprise

namestring required

Name of the enterprise

short_codestring 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_namestring

Registered Name of the enterprise

registered_addressstring

Registered address of the enterprise.

locationstring

City, State, Country location of the enterprise

zipcodestring

Zip code of enterprise location

contact_personstring nullable

Person who is the point of contact for the enterprise

contact_numberstring nullable

Contact number of the enterprise

contact_emailstring email

Contact email address of the enterprise

wifi_lte_toggle_flagboolean

Will only be available if feature is enabled

created_onstring date-time

Date and time of when this resource was created

updated_onstring date-time

Date and time of when this resource was updated