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

# Update an entity

> Update the business details of an existing legal entity.

Use this endpoint to complete or correct an entity's business details before
they are submitted for verification. Once an entity's details have been
submitted, only the contact details (`phone`, `website`, `description`) and
the business `address` remain updatable; the other fields are locked. Contact
Plane support to change a verified entity's legal details.

### Parameters

<ParamField type="string" path="id" initialValue="ent_cNqYX2J3s9bI2Aa" required>
  The ID of the entity to update.
</ParamField>

<ParamField body="name" type="string">
  The legal name of the entity as registered with government authorities.
</ParamField>

<ParamField body="country" type="string">
  Two-letter ISO country code (ISO 3166-1 alpha-2) where the entity is legally domiciled.
</ParamField>

<ParamField body="address" type="object">
  The primary business address of the entity.

  <Expandable title="child attributes">
    <ResponseField name="line1" type="string" required>
      Address line1 (e.g. street or company name).
    </ResponseField>

    <ResponseField name="line2" type="string">
      Address line2 (e.g. apartment, suite, unit or building). Pass `null` to clear it.
    </ResponseField>

    <ResponseField name="city" type="string" required>
      City, district, suburb, town, or village.
    </ResponseField>

    <ResponseField name="state" type="string" required>
      State, county, province, or region.
    </ResponseField>

    <ResponseField name="postal_code" type="string" required>
      ZIP or postal code.
    </ResponseField>

    <ResponseField name="country" type="string" required>
      Two-letter country code (ISO 3166-1 alpha-2).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="dba" type="string">
  "Doing Business As" name - the trade name used by the entity if different from the legal name.
</ParamField>

<ParamField body="description" type="string">
  A brief description of the entity's business activities or purpose.
</ParamField>

<ParamField body="email" type="string">
  Primary contact email address for the entity.
</ParamField>

<ParamField body="phone" type="string">
  Primary contact phone number for the entity.
</ParamField>

<ParamField body="website" type="string">
  The entity's primary website URL.
</ParamField>

<ParamField body="structure" type="string">
  The legal structure of the entity. Allowed values are `corporation`, `llc`, or `partnership`.
</ParamField>

<ParamField body="formation" type="object">
  Details about the entity's legal formation.

  <Expandable title="child attributes">
    <ResponseField name="country" type="string">
      Two-letter country code (ISO 3166-1 alpha-2) where the entity was formed.
    </ResponseField>

    <ResponseField name="state" type="string">
      The state or jurisdiction where the entity was formed.
    </ResponseField>

    <ResponseField name="date" type="string">
      The date when the entity was legally formed or incorporated (`YYYY-MM-DD`).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="tax_id" type="object">
  Tax identification information for the entity. Write-only: never returned in API responses.

  <Expandable title="child attributes">
    <ResponseField name="number" type="string" required>
      The tax identification number (e.g. EIN in the US).
    </ResponseField>

    <ResponseField name="country" type="string" required>
      Two-letter country code for the jurisdiction that issued the tax ID.
    </ResponseField>

    <ResponseField name="type" type="string">
      The type of tax ID (e.g. `ein`).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="metadata" type="object">
  Arbitrary key-value data to attach to the entity.
</ParamField>

### Returns

Returns the updated [Entity object](/reference/entities/object).

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "ent_kP9r2NqW6mT4s1Bc",
    "object": "entity",
    "name": "Acme Labs LLC",
    "country": "US",
    "address": {
      "line1": "548 Market Street",
      "line2": null,
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94104",
      "country": "US"
    },
    "status": "unverified",
    "dba": "Acme Labs",
    "description": null,
    "email": "labs@acmecorp.com",
    "phone": null,
    "website": null,
    "structure": "llc",
    "formation": {
      "country": "US",
      "state": "DE",
      "date": "2025-11-03"
    },
    "metadata": {},
    "created": "2026-05-27T12:00:00Z",
    "updated": "2026-05-28T09:30:00Z"
  }
  ```
</ResponseExample>