> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a business entity

> Partially update a reusable Commenda OS business entity. Omitted fields are left unchanged. Use this endpoint to complete corporate shareholder details before registering or validating incorporation participants.

Partially update a reusable Commenda OS business entity.

Use this endpoint to complete corporate shareholder details before registering the business entity as an incorporation participant, or before re-running incorporation validation after Commenda requests corrections.


## OpenAPI

````yaml PATCH /partner/commenda-os/customers/{customerId}/business-entities/{businessEntityId}
openapi: 3.0.1
info:
  title: Commenda Public APIs
  description: >-
    APIs for Commenda entity management, partner incorporation, indirect tax,
    compliance, and corporate operations.
  license:
    name: NONE
    url: NONE
  version: 1.0.0
servers:
  - url: https://api.prod.commenda.io/api/v1
    description: Commenda platform APIs, including Partner Incorporation and Commenda OS.
  - url: https://transaction-tax.api.in.commenda.io/api/v1
    description: Global Indirect Tax API.
security:
  - bearerAuth: []
paths:
  /partner/commenda-os/customers/{customerId}/business-entities/{businessEntityId}:
    patch:
      summary: Update a business entity
      description: >-
        Partially update a reusable Commenda OS business entity. Omitted fields
        are left unchanged. Use this endpoint to complete corporate shareholder
        details before registering or validating incorporation participants.
      operationId: updatePartnerCommendaOsBusinessEntity
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: integer
          description: Commenda customer identifier.
        - name: businessEntityId
          in: path
          required: true
          schema:
            type: integer
          description: Commenda business-entity identifier for the specified customer.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommendaOsBusinessEntityUpdateRequest'
            examples:
              updateBusinessEntity:
                value:
                  legalName: Acme Holdings Pte. Ltd.
                  businessDescription: Investment holding customer.
                  publicFacingWebsiteUrl: https://acme.example
      responses:
        '200':
          description: Business entity updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommendaOsBusinessEntityResponse'
        '400':
          description: Malformed business entity update payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommendaOsPartnerError'
        '401':
          description: Missing or invalid partner API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommendaOsPartnerError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommendaOsPartnerError'
        '404':
          description: Business entity not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommendaOsPartnerError'
      security:
        - xApiKeyAuth: []
      servers:
        - url: https://api.prod.commenda.io/api/v1
components:
  schemas:
    CommendaOsBusinessEntityUpdateRequest:
      type: object
      description: >-
        Partially update a reusable Commenda OS business entity. Omitted fields
        are left unchanged.
      properties:
        legalName:
          type: string
          minLength: 1
          maxLength: 1024
          example: Acme Holdings Pte. Ltd.
        dbaName:
          type: string
          minLength: 1
          maxLength: 1024
          example: Acme
        businessCode:
          type: string
          maxLength: 128
          example: '64202'
        businessDescription:
          type: string
          maxLength: 4096
          example: Investment holding company.
        dateOfClosure:
          type: string
          format: date-time
          description: ISO 8601 closure date.
          example: '2026-03-01T00:00:00.000Z'
        accountingBasis:
          type: string
          example: CASH
        taxedAs:
          type: string
          example: CORPORATION
        bookkeepingFrequency:
          type: string
          nullable: true
          example: MONTHLY
        nonUSBusinessEntityEIN:
          type: string
          description: Temporary non-US EIN handling field.
          example: 12-3456789
        requestedEIN:
          type: boolean
          description: Temporary non-US EIN handling field.
          example: false
        publicFacingWebsiteUrl:
          type: string
          format: uri
          example: https://acme.example
        fiscalYearDay:
          type: integer
          minimum: 1
          maximum: 31
          example: 31
        fiscalYearMonth:
          type: integer
          minimum: 1
          maximum: 12
          example: 12
        naicsCode:
          type: string
          description: NAICS business code.
          example: '551112'
        isIncorporationInProgress:
          type: boolean
          example: false
        countrySpecificFields:
          type: object
          description: >-
            Country-specific update payloads supported by the underlying
            Commenda OS business entity API.
          additionalProperties: true
      example:
        legalName: Acme Holdings Pte. Ltd.
        businessDescription: Investment holding company.
        publicFacingWebsiteUrl: https://acme.example
    CommendaOsBusinessEntityResponse:
      type: object
      required:
        - businessEntity
      properties:
        businessEntity:
          $ref: '#/components/schemas/CommendaOsBusinessEntity'
    CommendaOsPartnerError:
      type: object
      required:
        - statusCode
        - message
        - error
      properties:
        statusCode:
          type: integer
          description: HTTP status code for the error response.
        message:
          description: >-
            Error message returned by the API. Exact text varies by failure
            mode.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
        error:
          type: string
          description: Standard error label for the response status.
    CommendaOsBusinessEntity:
      type: object
      required:
        - id
        - generalBusinessEntityInfo
        - accountingInfo
        - featureSpecificInfo
        - entityRelationship
        - lastUpdateTime
      properties:
        id:
          type: integer
          example: 44
        generalBusinessEntityInfo:
          type: object
          required:
            - legalName
            - customerId
            - businessEntityType
            - incorporationCountry
            - jurisdiction
            - uniqueIdentifierFromJurisdiction
            - primaryTaxIdType
            - rootfiCompanies
          properties:
            legalName:
              type: string
              example: Acme Holdings LLC
            dbaName:
              type: string
              nullable: true
              example: Acme
            customerId:
              type: integer
              example: 77
            formationDate:
              type: string
              nullable: true
              example: '2025-01-01'
            registeredAddress:
              type: object
              additionalProperties: true
            businessEntityType:
              type: string
              example: LLC
            incorporationCountry:
              type: string
              example: US
            jurisdiction:
              type: string
              example: DE
            contactPhone:
              type: string
              nullable: true
              example: '+14155550123'
            entityEmail:
              type: string
              nullable: true
              format: email
              example: founders@acme.com
            uniqueIdentifierFromJurisdiction:
              $ref: '#/components/schemas/CommendaOsUniqueIdentifierFromJurisdiction'
            taxIds:
              type: array
              items:
                $ref: '#/components/schemas/CommendaOsTaxId'
            primaryTaxIdType:
              type: string
              example: US_EIN
            publicFacingWebsiteUrl:
              type: string
              nullable: true
              format: uri
              example: https://acme.com
            industryCode:
              type: object
              nullable: true
              additionalProperties: true
            businessDescription:
              type: string
              nullable: true
            businessPurpose:
              type: string
              nullable: true
            registeredAgent:
              type: object
              nullable: true
              additionalProperties: true
            dateOfClosure:
              type: string
              nullable: true
            rootfiCompanies:
              type: array
              items:
                type: object
                required:
                  - id
                  - connectionStatus
                  - syncStatus
                properties:
                  id:
                    type: integer
                    example: 1001
                  connectionStatus:
                    type: string
                    example: CONNECTED
                  syncStatus:
                    type: string
                    example: COMPLETED
        locationsInfo:
          type: object
          nullable: true
          additionalProperties: true
        accountingInfo:
          type: object
          properties:
            fiscalYear:
              type: object
              nullable: true
              additionalProperties: true
            accountingBasis:
              type: string
              nullable: true
            accountingFrequency:
              type: string
              nullable: true
            countrySpecificFields:
              type: object
              additionalProperties: true
            bankAccounts:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
            accountingFirm:
              type: object
              nullable: true
              additionalProperties: true
        stakeholderId:
          type: string
          nullable: true
        featureSpecificInfo:
          type: object
          additionalProperties: true
        onboardingInfo:
          type: object
          nullable: true
          additionalProperties: true
        entityRelationship:
          type: object
          additionalProperties: true
        structure:
          type: object
          nullable: true
          properties:
            initialSharesAuthorized:
              type: number
            initialSharePrice:
              type: number
            esopSharePercentage:
              type: number
        locations:
          type: array
          items:
            $ref: '#/components/schemas/CommendaOsLocation'
        governmentIdentifiers:
          type: array
          items:
            $ref: '#/components/schemas/CommendaOsGovernmentIdentifier'
        lastUpdateTime:
          type: string
          format: date-time
          example: '2026-03-01T00:00:00.000Z'
    CommendaOsUniqueIdentifierFromJurisdiction:
      type: object
      required:
        - name
      properties:
        name:
          type: string
          example: EIN
        value:
          type: string
          nullable: true
          example: 12-3456789
    CommendaOsTaxId:
      type: object
      required:
        - type
        - name
        - value
      properties:
        type:
          type: string
          example: US_EIN
        name:
          type: string
          example: Employer Identification Number
        value:
          type: string
          example: 12-3456789
    CommendaOsLocation:
      type: object
      required:
        - id
        - businessEntityId
        - locationTypes
        - address
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          example: loc_123
        name:
          type: string
          nullable: true
          example: Delaware HQ
        startDate:
          type: string
          nullable: true
          example: '2025-01-01'
        employeeCount:
          type: integer
          nullable: true
          example: 12
        businessEntityId:
          type: integer
          example: 44
        locationTypes:
          type: array
          items:
            type: string
          example:
            - OPERATIONS
        address:
          $ref: '#/components/schemas/CommendaOsLocationAddress'
        createdAt:
          type: integer
          example: 1735689600000
        updatedAt:
          type: integer
          example: 1735776000000
    CommendaOsGovernmentIdentifier:
      type: object
      required:
        - country
        - businessEntityId
        - corporationType
        - key
        - displayName
        - shortName
        - description
        - purposes
        - supportingDocument
        - isFunctionCritical
        - isCustom
        - linkedRegistrations
      properties:
        id:
          type: string
          nullable: true
          example: gov_123
        country:
          type: string
          example: US
        jurisdiction:
          type: string
          nullable: true
          example: DE
        businessEntityId:
          type: integer
          example: 44
        corporationType:
          type: string
          example: LLC
        key:
          type: string
          example: US_EIN
        value:
          type: string
          nullable: true
          example: 12-3456789
        displayName:
          type: string
          example: Employer Identification Number
        shortName:
          type: string
          example: EIN
        description:
          type: string
          example: US federal tax identifier issued by the IRS.
        purposes:
          type: array
          items:
            type: string
          example:
            - TAXATION
        supportingDocument:
          $ref: >-
            #/components/schemas/CommendaOsGovernmentIdentifierSupportingDocument
        isFunctionCritical:
          type: boolean
          example: true
        createdAt:
          type: integer
          nullable: true
          example: 1735689600000
        lastUpdatedAt:
          type: integer
          nullable: true
          example: 1735776000000
        regexString:
          type: string
          nullable: true
        isCustom:
          type: boolean
          example: false
        linkedRegistrations:
          type: array
          items:
            $ref: '#/components/schemas/CommendaOsLinkedRegistrationOption'
    CommendaOsLocationAddress:
      type: object
      required:
        - addressLine1
        - postalCode
        - country
      properties:
        addressLine1:
          type: string
          example: 548 Market St
        addressLine2:
          type: string
          nullable: true
          example: Suite 21045
        addressLine3:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
          example: San Francisco
        postalCode:
          type: string
          example: '94104'
        state:
          type: string
          nullable: true
          example: CA
        country:
          type: string
          example: US
    CommendaOsGovernmentIdentifierSupportingDocument:
      type: object
      required:
        - id
        - fileName
        - fileUrl
        - type
        - category
        - fileTypeSpecifiers
      properties:
        id:
          type: integer
          nullable: true
          example: 900
        fileName:
          type: string
          example: ein-letter.pdf
        fileUrl:
          type: string
          nullable: true
          format: uri
          example: https://bucket.s3.amazonaws.com/ein-letter.pdf
        type:
          type: string
          example: EINLetter
        category:
          type: string
          example: TAX_AND_COMPLIANCE_DOCUMENT
        fileTypeSpecifiers:
          type: array
          items:
            type: string
          example:
            - .pdf
    CommendaOsLinkedRegistrationOption:
      type: object
      required:
        - internalIdentifier
        - displayName
        - purpose
      properties:
        internalIdentifier:
          type: string
          example: US_EIN
        displayName:
          type: string
          example: Employer Identification Number
        purpose:
          type: string
          example: TAXATION
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    xApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````