Access Tokens1

Addresses6

Advanced Number Orders4

Assistants46

Audio1

Audit Logs1

Authentication Providers5

AutoRechargePreferences2

Billing1

Billing Groups5

Brands15

Bucket SSL Certificate3

Bucket Usage2

Bulk Phone Number Campaigns3

Bulk Phone Number Operations5

Bundles2

Call Commands41

Call Control Applications5

Call Information2

Call Recordings11

Campaign13

CDR Reports5

CDR Usage Reports5

Chat4

Clusters5

Comments2

Conference Commands23

Connections2

Conversation Histories1

Conversations20

Country Coverage2

Coverage1

Credential Connections6

Credentials5

CSV Downloads3

Customer Service Record4

Data Migration9

Debugging1

Detail Records1

Dialogflow Integration4

Display Identity Records8

Documents9

Dynamic Emergency Addresses4

Dynamic Emergency Endpoints4

Embeddings8

Enterprises6

Enum1

External Connections23

Fine Tuning4

FQDN Connections5

FQDNs5

Global IPs20

Hosted Numbers9

Inexplicit Number Orders3

Infringement Claims4

Integration Secrets3

Integrations5

Inventory Level1

IP Addresses4

IP Connections5

IP Ranges3

IPs5

Managed Accounts8

MCP Servers5

MDR Detail Reports1

MDR Detailed Reports4

MDR Usage Reports9

Media Storage API6

Messages10

Messaging11

Messaging URL Domains1

Missions41

Mobile Network Operators1

Mobile Number Settings2

Mobile Phone Numbers3

Mobile Voice Connections5

Networks9

Notifications16

Number Lookup1

Number Portout14

Number Settings5

numbers features1

OAuth Clients5

OAuth Discovery2

OAuth Grants3

OAuth Protocol7

OpenAI Chat3

OpenAI Embeddings2

Opt-Out Management6

Organization Users4

OTA updates2

Outbound Voice Profiles5

Phone Number Batches2

Phone Number Block Orders3

Phone Number Blocks Background Jobs3

Phone Number Campaigns5

Phone Number Configurations11

Phone Number Orders18

Phone Number Porting1

Phone Number Reservations4

Phone Number Search2

Phone Numbers3

Porting Orders53

Presigned Object URLs1

Private Wireless Gateways4

Profiles7

Programmable Fax Applications5

Programmable Fax Commands6

Pronunciation Dictionaries5

Public Internet Gateways4

Push Credentials4

Queue Commands9

RCS8

Reference Data3

Regions1

Regulatory Requirements2

Reporting4

Reports2

Reputation17

Requirement Groups8

Requirement Types2

Requirements2

Room Compositions4

Room Participants2

Room Recordings4

Room Sessions7

Rooms6

Rooms Client Tokens2

Session Analysis3

SETI Observability1

Shared Campaigns5

Short Codes3

SIM Card Actions4

SIM Card Group Actions2

SIM Card Groups9

SIM Card Orders4

SIM Cards24

SIPREC Connectors4

Speech to Text Batch Reports4

Speech To Text Capabilities1

Speech To Text over WebSockets1

Speech to text Usage Reports1

Stored Payment Transactions1

Telco Data Usage Reports4

Terms of Service6

TeXML Applications5

TeXML REST Commands34

Text To Speech Commands3

Traffic Policy Profiles6

UAC Connections7

Usage Reports (BETA)2

User Bundles6

User Tags1

UserAddresses3

Verification Requests6

Verified Numbers5

Verify16

Virtual Cross Connects6

Voice Channels6

Voice Clones6

Voice Designs7

Voice SDK Stats2

Voicemail3

WDR Detail Reports1

Webhooks2

Whatsapp Business Accounts8

Whatsapp Message Templates5

Whatsapp messaging1

Whatsapp Phone Numbers12

WireGuard Interfaces10

Wireless Blocklists6

Wireless Regions1

x402 Payment Transactions2

Webhooks

Callbacks66

Enterprises

Replace an enterprise

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).

put/enterprises/{enterprise_id}

Path parameters

enterprise_idstring uuid required

Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

legal_namestring

Legal name of the enterprise.

websitestring uri

feinstring

number_of_employeesstring

organization_legal_typestring

doing_business_asstring

customer_referencestring

primary_business_domain_sic_codestring nullable

corporate_registration_numberstring nullable

professional_license_numberstring nullable

dun_bradstreet_numberstring nullable

jurisdiction_of_incorporationstring

Updated state/province/country of incorporation. Optional on update.

Example request

{
  "organization_contact": {
    "first_name": "Sam",
    "last_name": "Org",
    "email": "sam@acmeplumbing.example.com",
    "job_title": "Compliance Lead",
    "phone_number": "+13125550000"
  },
  "billing_contact": {
    "first_name": "Alex",
    "last_name": "Bill",
    "email": "billing@acmeplumbing.example.com",
    "phone_number": "+13125550001"
  },
  "organization_physical_address": {
    "country": "US",
    "administrative_area": "IL",
    "city": "Chicago",
    "postal_code": "60601",
    "street_address": "100 Main St",
    "extended_address": "Suite 504"
  },
  "billing_address": {
    "country": "US",
    "administrative_area": "IL",
    "city": "Chicago",
    "postal_code": "60601",
    "street_address": "100 Main St",
    "extended_address": "Suite 504"
  },
  "jurisdiction_of_incorporation": "Delaware"
}

Response

Enterprise updated.

Example response

{
  "data": {
    "id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "legal_name": "Acme Plumbing LLC",
    "organization_type": "commercial",
    "country_code": "US",
    "role_type": "enterprise",
    "website": "https://acmeplumbing.example.com",
    "fein": "12-3456789",
    "industry": "technology",
    "number_of_employees": "51-200",
    "organization_legal_type": "llc",
    "doing_business_as": "Acme Plumbing",
    "jurisdiction_of_incorporation": "Delaware",
    "customer_reference": "internal-id-12345",
    "organization_contact": {
      "first_name": "Sam",
      "last_name": "Org",
      "email": "sam@acmeplumbing.example.com",
      "job_title": "Compliance Lead",
      "phone_number": "+13125550000"
    },
    "billing_contact": {
      "first_name": "Alex",
      "last_name": "Bill",
      "email": "billing@acmeplumbing.example.com",
      "phone_number": "+13125550001"
    },
    "organization_physical_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "billing_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "created_at": "2026-04-26T18:06:51.940749Z",
    "updated_at": "2026-04-26T18:09:24.785211Z"
  }
}

Changes

Changed in 1 of the 47 revisions of this API.28898

Jun 5, 20268a8c40f458c528898See the full diff
- ▲
  added the new required request property organization_contact/phone_number
  new-required-request-property
- ▲
  request property industry was restricted to a list of enum values
  request-property-became-enum
- ▲
  removed the enum value 1-10 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 10001+ of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 11-50 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 2001-10000 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 201-500 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 501-2000 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value 51-200 of the request property number_of_employees
  request-property-enum-value-removed
- ▲
  removed the enum value corporation of the request property organization_legal_type
  request-property-enum-value-removed
- ▲
  removed the enum value llc of the request property organization_legal_type
  request-property-enum-value-removed
- ▲
  removed the enum value nonprofit of the request property organization_legal_type
  request-property-enum-value-removed
- ▲
  removed the enum value other of the request property organization_legal_type
  request-property-enum-value-removed
- ▲
  removed the enum value partnership of the request property organization_legal_type
  request-property-enum-value-removed
- ▲
  the billing_address request property type/format changed from object/ to /
  request-property-type-changed
- ▲
  the website request property type/format changed from string/ to string/uri
  request-property-type-changed
- ▲
  the data/billing_contact/email response property's maxLength was unset from 255 for the response status 200
  response-property-max-length-unset
- ▲
  the data/billing_contact/phone_number response property's maxLength was unset from 20 for the response status 200
  response-property-max-length-unset
- ▲
  the data/organization_contact/email response property's maxLength was unset from 255 for the response status 200
  response-property-max-length-unset
- ▲
  the data/organization_physical_address/administrative_area response property's maxLength was unset from 100 for the response status 200
  response-property-max-length-unset
- ▲
  the data/organization_physical_address/country response property's maxLength was unset from 100 for the response status 200
  response-property-max-length-unset
- ▲
  the data/billing_address response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  removed the required property data/billing_address/administrative_area from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/billing_address/city from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/billing_address/country from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/billing_address/postal_code from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/billing_address/street_address from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/organization_contact/phone from the response with the 200 status
  response-required-property-removed
- ●
  removed the request property billing_address/administrative_area
  request-property-removed
- ●
  removed the request property billing_address/city
  request-property-removed
- ●
  removed the request property billing_address/country
  request-property-removed
- ●
  removed the request property billing_address/extended_address
  request-property-removed
- ●
  removed the request property billing_address/postal_code
  request-property-removed
- ●
  removed the request property billing_address/street_address
  request-property-removed
- ●
  removed the request property organization_contact/phone
  request-property-removed
- ●
  removed the optional property data/billing_address/extended_address from the response with the 200 status
  response-optional-property-removed
- ○
  api operation id UpdateEnterprise removed and replaced with updateEnterprise
  api-operation-id-removed
- ○
  added the new optional request property jurisdiction_of_incorporation
  new-optional-request-property
- ○
  the request property corporate_registration_number became nullable
  request-property-became-nullable
- ○
  the request property dun_bradstreet_number became nullable
  request-property-became-nullable
- ○
  the request property primary_business_domain_sic_code became nullable
  request-property-became-nullable
- ○
  the request property professional_license_number became nullable
  request-property-became-nullable
- ○
  added the new accounting enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new banking enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new billing enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new business enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new charity enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new collections enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new communications enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new customer service enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new delivery enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new ecommerce enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new education enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new finance enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new financial enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new government enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new health enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new healthcare enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new hospitality enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new hotel enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new insurance enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new law enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new legal enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new logistics enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new market research enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new marketing enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new media enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new medical enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new nonprofit enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new notifications enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new pharmacy enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new property enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new public enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new real estate enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new retail enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new sales enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new scheduling enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new shipping enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new software enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new support enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new surveys enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new tech enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new technology enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new telecom enum value to the request property industry
  request-property-enum-value-added
- ○
  added the new travel enum value to the request property industry
  request-property-enum-value-added
- ○
  added the optional property data/branded_calling_enabled to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/jurisdiction_of_incorporation to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/number_reputation_enabled to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_codes to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_codes to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_codes to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_ids to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_ids to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_ids to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_labels to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_labels to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property errors/items/meta/pending_check_labels to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property errors/items/source/parameter to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property errors/items/source/parameter to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property errors/items/source/parameter to the response with the 404 status
  response-optional-property-added
- ○
  the response optional property data/created_at became read-only for the status 200
  response-optional-property-became-read-only
- ○
  the response optional property data/id became read-only for the status 200
  response-optional-property-became-read-only
- ○
  the response optional property data/updated_at became read-only for the status 200
  response-optional-property-became-read-only
- ○
  the response property data became required for the status 200
  response-property-became-required
- ○
  the response property errors became required for the status 400
  response-property-became-required
- ○
  the response property errors became required for the status 401
  response-property-became-required
- ○
  the response property errors became required for the status 404
  response-property-became-required
- ○
  the response property errors/items/detail became required for the status 400
  response-property-became-required
- ○
  the response property errors/items/detail became required for the status 401
  response-property-became-required
- ○
  the response property errors/items/detail became required for the status 404
  response-property-became-required
- ○
  the response property errors/items/meta became required for the status 400
  response-property-became-required
- ○
  the response property errors/items/meta became required for the status 401
  response-property-became-required
- ○
  the response property errors/items/meta became required for the status 404
  response-property-became-required
- ○
  the response property errors/items/meta/url became required for the status 400
  response-property-became-required
- ○
  the response property errors/items/meta/url became required for the status 401
  response-property-became-required
- ○
  the response property errors/items/meta/url became required for the status 404
  response-property-became-required
- ○
  removed the 1-10 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 10001+ enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 11-50 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2001-10000 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 201-500 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 501-2000 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 51-200 enum value from the data/number_of_employees response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bpo enum value from the data/role_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the commercial enum value from the data/organization_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the corporation enum value from the data/organization_legal_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the enterprise enum value from the data/role_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the government enum value from the data/organization_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the llc enum value from the data/organization_legal_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the non_profit enum value from the data/organization_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the nonprofit enum value from the data/organization_legal_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the other enum value from the data/organization_legal_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the partnership enum value from the data/organization_legal_type response property for the response status 200
  response-property-enum-value-removed
- ○
  added the required property data/organization_contact/phone_number to the response with the 200 status
  response-required-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history