---
title: "Replace an enterprise"
method: PUT
path: "/enterprises/{enterprise_id}"
tags: ["Enterprises"]
---

# Replace an enterprise

`PUT /enterprises/{enterprise_id}`

Replace the enterprise's mutable fields. Only mutable fields may be sent. Server-assigned and immutable fields (`id`, `record_type`, `created_at`, `updated_at`, status fields, `organization_type`, `country_code`, `role_type`) cannot be changed: including any of them in the body is rejected with `400 Bad Request` (`Field 'X' is not allowed in this request`).

## Path parameters

- `enterprise_id` string, uuid, required

## Request body

- EnterpriseUpdate — All fields are optional; only the ones supplied are updated. The same field-level rules from `EnterpriseCreateRequest` apply.
  - `legal_name` string — Legal name of the enterprise.
  - `website` string, uri
  - `fein` string
  - `industry` 'accounting' | 'finance' | 'billing' | 'collections' | 'business' | 'charity' | 'nonprofit' | 'communications' | 'telecom' | 'customer service' | 'support' | 'delivery' | 'shipping' | 'logistics' | 'education' | 'financial' | 'banking' | 'government' | 'public' | 'healthcare' | 'health' | 'pharmacy' | 'medical' | 'insurance' | 'legal' | 'law' | 'notifications' | 'scheduling' | 'real estate' | 'property' | 'retail' | 'ecommerce' | 'sales' | 'marketing' | 'software' | 'technology' | 'tech' | 'media' | 'surveys' | 'market research' | 'travel' | 'hospitality' | 'hotel'
  - `number_of_employees` string
  - `organization_legal_type` string
  - `doing_business_as` string
  - `customer_reference` string
  - `primary_business_domain_sic_code` string, nullable
  - `corporate_registration_number` string, nullable
  - `professional_license_number` string, nullable
  - `dun_bradstreet_number` string, nullable
  - `organization_contact` OrganizationContact
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
    - `job_title` string, required
    - `phone_number` string, required — E.164 format with leading `+`.
  - `billing_contact` BillingContact
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
    - `phone_number` string, required — E.164 format with leading `+`.
  - `organization_physical_address` PhysicalAddress
    - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
    - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
    - `city` string, required
    - `postal_code` string, required
    - `street_address` string, required
    - `extended_address` string, nullable
  - `billing_address` BillingAddress
    - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
    - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
    - `city` string, required
    - `postal_code` string, required
    - `street_address` string, required
    - `extended_address` string, nullable
  - `jurisdiction_of_incorporation` string — Updated state/province/country of incorporation. Optional on update.

## Response `200`

Enterprise updated.

- EnterprisePublicWrapped
  - `data` EnterprisePublic, required
    - `id` string, uuid
    - `legal_name` string
    - `organization_type` string
    - `country_code` string
    - `role_type` string
    - `website` string
    - `fein` string
    - `industry` string
    - `number_of_employees` string
    - `organization_legal_type` string
    - `doing_business_as` string
    - `jurisdiction_of_incorporation` string
    - `customer_reference` string
    - `primary_business_domain_sic_code` string, nullable — Optional SIC code for the primary line of business.
    - `corporate_registration_number` string, nullable — Optional corporate-registration / company-number identifier.
    - `professional_license_number` string, nullable — Optional professional-license number for regulated industries.
    - `dun_bradstreet_number` string, nullable — Optional D-U-N-S Number issued by Dun & Bradstreet.
    - `organization_contact` OrganizationContact
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `job_title` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `billing_contact` BillingContact
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `organization_physical_address` PhysicalAddress
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `postal_code` string, required
      - `street_address` string, required
      - `extended_address` string, nullable
    - `billing_address` BillingAddress
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `postal_code` string, required
      - `street_address` string, required
      - `extended_address` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `branded_calling_enabled` boolean — True once Branded Calling has been activated on this enterprise (see `POST /enterprises/{id}/branded_calling`).
    - `number_reputation_enabled` boolean — True once Phone Number Reputation has been enabled on this enterprise (see `POST /enterprises/{id}/reputation`).

## Other responses

- `400` — An error occurred. The response carries the standard Telnyx error envelope.
- `401` — An error occurred. The response carries the standard Telnyx error envelope.
- `404` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)