> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # 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`). ## OpenAPI ````yaml https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/number-reputation/enterprises.yml put /enterprises/{enterprise_id} openapi: 3.1.0 info: title: Telnyx Number Reputation Enterprises API version: 2.0.0 description: >- Manage enterprises for Number Reputation. An enterprise represents your business entity and is the top-level resource for reputation monitoring. Register your organization once, then enable Number Reputation to start monitoring your phone numbers' spam reputation. contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 security: - bearerAuth: [] paths: /enterprises/{enterprise_id}: put: tags: - Enterprises summary: Replace an enterprise description: >- 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`). operationId: updateEnterprise parameters: - $ref: '#/components/parameters/EnterpriseId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EnterpriseUpdate' example: legal_name: Acme Plumbing LLC doing_business_as: Acme Plumbing organization_legal_type: llc industry: business number_of_employees: 51-200 jurisdiction_of_incorporation: Delaware website: https://acmeplumbing.example.com fein: 12-3456789 customer_reference: internal-ref-2026Q2 organization_contact: first_name: Sam last_name: Owner 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 billing_address: country: US administrative_area: IL city: Chicago postal_code: '60601' street_address: 100 Main St responses: '200': description: Enterprise updated. content: application/json: schema: $ref: '#/components/schemas/EnterprisePublicWrapped' '400': $ref: '#/components/responses/branded-calling_GenericErrorResponse' '401': $ref: '#/components/responses/branded-calling_GenericErrorResponse' '404': $ref: '#/components/responses/branded-calling_GenericErrorResponse' x-codeSamples: - lang: JavaScript source: >- import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted }); const enterprise = await client.enterprises.update('4a6192a4-573d-446d-b3ce-aff9117272a6', { billing_address: { country: 'US', administrative_area: 'IL', city: 'Chicago', postal_code: '60601', street_address: '100 Main St', }, billing_contact: { first_name: 'Alex', last_name: 'Bill', email: 'billing@acmeplumbing.example.com', phone_number: '+13125550001', }, customer_reference: 'internal-ref-2026Q2', doing_business_as: 'Acme Plumbing', fein: '12-3456789', industry: 'business', jurisdiction_of_incorporation: 'Delaware', legal_name: 'Acme Plumbing LLC', number_of_employees: '51-200', organization_contact: { first_name: 'Sam', last_name: 'Owner', email: 'sam@acmeplumbing.example.com', job_title: 'Compliance Lead', phone_number: '+13125550000', }, organization_legal_type: 'llc', organization_physical_address: { country: 'US', administrative_area: 'IL', city: 'Chicago', postal_code: '60601', street_address: '100 Main St', }, website: 'https://acmeplumbing.example.com', }); console.log(enterprise.data); - lang: Python source: |- import os from telnyx import Telnyx client = Telnyx( api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted ) enterprise = client.enterprises.update( enterprise_id="4a6192a4-573d-446d-b3ce-aff9117272a6", billing_address={ "country": "US", "administrative_area": "IL", "city": "Chicago", "postal_code": "60601", "street_address": "100 Main St", }, billing_contact={ "first_name": "Alex", "last_name": "Bill", "email": "billing@acmeplumbing.example.com", "phone_number": "+13125550001", }, customer_reference="internal-ref-2026Q2", doing_business_as="Acme Plumbing", fein="12-3456789", industry="business", jurisdiction_of_incorporation="Delaware", legal_name="Acme Plumbing LLC", number_of_employees="51-200", organization_contact={ "first_name": "Sam", "last_name": "Owner", "email": "sam@acmeplumbing.example.com", "job_title": "Compliance Lead", "phone_number": "+13125550000", }, organization_legal_type="llc", organization_physical_address={ "country": "US", "administrative_area": "IL", "city": "Chicago", "postal_code": "60601", "street_address": "100 Main St", }, website="https://acmeplumbing.example.com", ) print(enterprise.data) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tenterprise, err := client.Enterprises.Update(\n\t\tcontext.TODO(),\n\t\t\"4a6192a4-573d-446d-b3ce-aff9117272a6\",\n\t\ttelnyx.EnterpriseUpdateParams{\n\t\t\tBillingAddress: telnyx.BillingAddressParam{\n\t\t\t\tCountry: \"US\",\n\t\t\t\tAdministrativeArea: \"IL\",\n\t\t\t\tCity: \"Chicago\",\n\t\t\t\tPostalCode: \"60601\",\n\t\t\t\tStreetAddress: \"100 Main St\",\n\t\t\t},\n\t\t\tBillingContact: telnyx.BillingContactParam{\n\t\t\t\tFirstName: \"Alex\",\n\t\t\t\tLastName: \"Bill\",\n\t\t\t\tEmail: \"billing@acmeplumbing.example.com\",\n\t\t\t\tPhoneNumber: \"+13125550001\",\n\t\t\t},\n\t\t\tCustomerReference: telnyx.String(\"internal-ref-2026Q2\"),\n\t\t\tDoingBusinessAs: telnyx.String(\"Acme Plumbing\"),\n\t\t\tFein: telnyx.String(\"12-3456789\"),\n\t\t\tIndustry: telnyx.EnterpriseUpdateParamsIndustryBusiness,\n\t\t\tJurisdictionOfIncorporation: telnyx.String(\"Delaware\"),\n\t\t\tLegalName: telnyx.String(\"Acme Plumbing LLC\"),\n\t\t\tNumberOfEmployees: telnyx.String(\"51-200\"),\n\t\t\tOrganizationContact: telnyx.OrganizationContactParam{\n\t\t\t\tFirstName: \"Sam\",\n\t\t\t\tLastName: \"Owner\",\n\t\t\t\tEmail: \"sam@acmeplumbing.example.com\",\n\t\t\t\tJobTitle: \"Compliance Lead\",\n\t\t\t\tPhoneNumber: \"+13125550000\",\n\t\t\t},\n\t\t\tOrganizationLegalType: telnyx.String(\"llc\"),\n\t\t\tOrganizationPhysicalAddress: telnyx.PhysicalAddressParam{\n\t\t\t\tCountry: \"US\",\n\t\t\t\tAdministrativeArea: \"IL\",\n\t\t\t\tCity: \"Chicago\",\n\t\t\t\tPostalCode: \"60601\",\n\t\t\t\tStreetAddress: \"100 Main St\",\n\t\t\t},\n\t\t\tWebsite: telnyx.String(\"https://acmeplumbing.example.com\"),\n\t\t},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", enterprise.Data)\n}\n" - lang: Java source: |- package com.telnyx.sdk.example; import com.telnyx.sdk.client.TelnyxClient; import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient; import com.telnyx.sdk.models.enterprises.EnterpriseUpdateParams; import com.telnyx.sdk.models.enterprises.EnterpriseUpdateResponse; public final class Main { private Main() {} public static void main(String[] args) { TelnyxClient client = TelnyxOkHttpClient.fromEnv(); EnterpriseUpdateResponse enterprise = client.enterprises().update("4a6192a4-573d-446d-b3ce-aff9117272a6"); } } - lang: Ruby source: >- require "telnyx" telnyx = Telnyx::Client.new(api_key: "My API Key") enterprise = telnyx.enterprises.update("4a6192a4-573d-446d-b3ce-aff9117272a6") puts(enterprise) - lang: PHP source: >- enterprises->update( '4a6192a4-573d-446d-b3ce-aff9117272a6', billingAddress: [ 'administrativeArea' => 'IL', 'city' => 'Chicago', 'country' => 'US', 'postalCode' => '60601', 'streetAddress' => '100 Main St', 'extendedAddress' => 'Suite 504', ], billingContact: [ 'email' => 'billing@acmeplumbing.example.com', 'firstName' => 'Alex', 'lastName' => 'Bill', 'phoneNumber' => '+13125550001', ], corporateRegistrationNumber: 'corporate_registration_number', customerReference: 'internal-ref-2026Q2', doingBusinessAs: 'Acme Plumbing', dunBradstreetNumber: 'dun_bradstreet_number', fein: '12-3456789', industry: 'business', jurisdictionOfIncorporation: 'Delaware', legalName: 'Acme Plumbing LLC', numberOfEmployees: '51-200', organizationContact: [ 'email' => 'sam@acmeplumbing.example.com', 'firstName' => 'Sam', 'jobTitle' => 'Compliance Lead', 'lastName' => 'Owner', 'phoneNumber' => '+13125550000', ], organizationLegalType: 'llc', organizationPhysicalAddress: [ 'administrativeArea' => 'IL', 'city' => 'Chicago', 'country' => 'US', 'postalCode' => '60601', 'streetAddress' => '100 Main St', 'extendedAddress' => 'Suite 504', ], primaryBusinessDomainSicCode: 'primary_business_domain_sic_code', professionalLicenseNumber: 'professional_license_number', website: 'https://acmeplumbing.example.com', ); var_dump($enterprise); } catch (APIException $e) { echo $e->getMessage(); } - lang: CLI source: |- telnyx enterprises update \ --api-key 'My API Key' \ --enterprise-id 4a6192a4-573d-446d-b3ce-aff9117272a6 components: parameters: EnterpriseId: name: enterprise_id in: path description: The enterprise id. Lowercase UUID. required: true schema: type: string format: uuid example: 4a6192a4-573d-446d-b3ce-aff9117272a6 schemas: EnterpriseUpdate: type: object description: >- All fields are optional; only the ones supplied are updated. The same field-level rules from `EnterpriseCreateRequest` apply. properties: legal_name: type: string description: Legal name of the enterprise. minLength: 3 maxLength: 64 website: type: string format: uri maxLength: 255 fein: type: string industry: type: string enum: - 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: type: string organization_legal_type: type: string doing_business_as: type: string maxLength: 255 customer_reference: type: string maxLength: 255 primary_business_domain_sic_code: type: string nullable: true corporate_registration_number: type: string nullable: true professional_license_number: type: string nullable: true dun_bradstreet_number: type: string nullable: true organization_contact: $ref: '#/components/schemas/OrganizationContact' billing_contact: $ref: '#/components/schemas/BillingContact' organization_physical_address: $ref: '#/components/schemas/PhysicalAddress' billing_address: $ref: '#/components/schemas/PhysicalAddress' jurisdiction_of_incorporation: type: string maxLength: 255 description: Updated state/province/country of incorporation. Optional on update. example: Delaware EnterprisePublicWrapped: type: object required: - data properties: data: $ref: '#/components/schemas/EnterprisePublic' OrganizationContact: type: object required: - first_name - last_name - email - job_title - phone_number properties: first_name: type: string maxLength: 255 example: Sam last_name: type: string maxLength: 255 example: Org email: type: string format: email example: sam@acmeplumbing.example.com job_title: type: string maxLength: 255 example: Compliance Lead phone_number: type: string description: E.164 format with leading `+`. example: '+13125550000' BillingContact: type: object required: - first_name - last_name - email - phone_number properties: first_name: type: string maxLength: 255 example: Alex last_name: type: string maxLength: 255 example: Bill email: type: string format: email example: billing@acmeplumbing.example.com phone_number: type: string description: E.164 format with leading `+`. example: '+13125550001' PhysicalAddress: type: object required: - country - administrative_area - city - postal_code - street_address properties: country: type: string description: ISO 3166-1 alpha-2 code (currently `US` or `CA`). example: US administrative_area: type: string description: State or province code (e.g. `IL`, `ON`). example: IL city: type: string maxLength: 100 example: Chicago postal_code: type: string maxLength: 20 example: '60601' street_address: type: string maxLength: 255 example: 100 Main St extended_address: type: string maxLength: 255 example: Suite 504 nullable: true EnterprisePublic: type: object properties: id: type: string format: uuid example: 4a6192a4-573d-446d-b3ce-aff9117272a6 readOnly: true legal_name: type: string example: Acme Plumbing LLC organization_type: type: string example: commercial country_code: type: string example: US role_type: type: string example: enterprise website: type: string example: https://acmeplumbing.example.com fein: type: string example: 12-3456789 industry: type: string example: technology number_of_employees: type: string example: 51-200 organization_legal_type: type: string example: llc doing_business_as: type: string example: Acme Plumbing jurisdiction_of_incorporation: type: string example: Delaware customer_reference: type: string example: internal-id-12345 primary_business_domain_sic_code: type: string nullable: true description: Optional SIC code for the primary line of business. example: null corporate_registration_number: type: string nullable: true description: Optional corporate-registration / company-number identifier. example: null professional_license_number: type: string nullable: true description: Optional professional-license number for regulated industries. example: null dun_bradstreet_number: type: string nullable: true description: Optional D-U-N-S Number issued by Dun & Bradstreet. example: null organization_contact: $ref: '#/components/schemas/OrganizationContact' billing_contact: $ref: '#/components/schemas/BillingContact' organization_physical_address: $ref: '#/components/schemas/PhysicalAddress' billing_address: $ref: '#/components/schemas/PhysicalAddress' created_at: type: string format: date-time example: '2026-04-26T18:06:51.940749Z' readOnly: true updated_at: type: string format: date-time example: '2026-04-26T18:09:24.785211Z' readOnly: true branded_calling_enabled: type: boolean description: >- True once Branded Calling has been activated on this enterprise (see `POST /enterprises/{id}/branded_calling`). number_reputation_enabled: type: boolean description: >- True once Phone Number Reputation has been enabled on this enterprise (see `POST /enterprises/{id}/reputation`). branded-calling_Errors: type: object required: - errors properties: errors: type: array items: $ref: '#/components/schemas/branded-calling_Error' description: List of one or more error entries. Order is not significant. description: >- Canonical Telnyx error envelope. Returned on every 4xx and 5xx response from this service. `errors` is non-empty; multiple entries indicate multiple distinct problems with the same request (e.g. one entry per invalid phone number on a bulk operation). branded-calling_Error: type: object required: - code - title - detail - meta properties: code: type: string example: '10005' description: >- Stable numeric Telnyx error catalog id. See `meta.url` for the full catalog entry. title: type: string example: Invalid parameters description: >- Short human-readable category, e.g. `Bad Request`, `Duplicate resource`, `Not Found`, `Forbidden`. Treat as advisory only - the stable identifier is `code`. detail: type: string example: field required description: >- Context-specific message describing what went wrong on this particular request. May embed offending values; do not rely on it for programmatic matching - branch on `code`. meta: type: object required: - url properties: url: type: string format: uri example: https://developers.telnyx.com/docs/overview/errors/10005 pending_check_ids: type: array items: type: string format: uuid description: >- Set on `422 vetting_checks_incomplete` responses from `/admin/dir/{id}/approve` and `/admin/phone-number-batches/approve`. Lists the still-pending vetting check ids. pending_check_codes: type: array items: type: string description: >- Codes of the pending vetting checks (e.g. `loa_signature_valid`). pending_check_labels: type: array items: type: string description: Human-readable labels of the pending vetting checks. description: >- Carries `url` linking to the Telnyx error catalog entry for this `code`. Useful for forwarding the user to documentation. source: type: object description: Optional pointer at the offending field of the request. properties: pointer: type: string example: /body/legal_name parameter: type: string example: page[size] description: >- A single entry in the canonical Telnyx error envelope. `code` is the stable Telnyx error catalog id; the human-readable explanation lives at `meta.url`. `detail` is a context-specific message; `source.pointer` (when present) names the offending field of the request. responses: branded-calling_GenericErrorResponse: description: >- An error occurred. The response carries the standard Telnyx error envelope. content: application/json: schema: $ref: '#/components/schemas/branded-calling_Errors' examples: validation_error: summary: 422 - request body failed validation value: errors: - code: '10005' title: Invalid parameters detail: field required meta: url: https://developers.telnyx.com/docs/overview/errors/10005 source: pointer: /body/legal_name bad_request: summary: 400 - request rejected by a state guard description: >- Returned when the request itself is well-formed but the resource is in a state that disallows this action (e.g. updating a DIR while it is being vetted, or deleting an enterprise that still has DIRs in vetting). value: errors: - code: '10015' title: Bad Request detail: Cannot update DIR in 'verified' status meta: url: https://developers.telnyx.com/docs/overview/errors/10015 not_found: summary: 404 - resource does not exist or is not yours value: errors: - code: '10009' title: Resource not found detail: Enterprise not found. meta: url: https://developers.telnyx.com/docs/overview/errors/10009 conflict: summary: 409 - request conflicts with current resource state value: errors: - code: '10021' title: Resource in use detail: >- DIR has 1 active infringement claim(s). Resolve the claim before making this change. meta: url: https://developers.telnyx.com/docs/overview/errors/10021 securitySchemes: bearerAuth: scheme: bearer type: http ````