---
title: "Update legal person"
method: PUT
path: "/v0/legal-persons/{legal-person-id}"
tags: ["Legal persons"]
---

# Update legal person

`PUT /v0/legal-persons/{legal-person-id}`

Updates the legal-person.

## Path parameters

- `legal-person-id` string, required

## Request body

- object
  - `display-name` string, required — A human readable label for an entity

## Response `200`

OK

- object
  - `latest-decision` object — The most recent [decision](#tag/Decisions)
    - `decision-outcome` 'accepted' | 'declined', required
    - `decision-notes` string, required — Free-text field to explain the reasons behind the decision.
    - `verification-url` string, required — A link to the [verification](#tag/Verifications).
    - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
      - string
      - string
    - `created-at` string, date-time, required — ISO 8601 formatted date-time.
    - `decision-maker` 'system' | 'ops-user' | 'user', required — Indicates if the decision was automated or made by a human.
    - `decision-user-url` string — Link to the [user](#tag/Users) that made the decision (if applicable).
    - `decision-ops-user` 'griffin-ops-user' — Indicates that an Ops user has created the decision.
    - `decision-user-username` string — Username of the [user](#tag/Users) that made the decision (if applicable).
  - `legal-person-type` 'individual' | 'corporation', required — Specifies if the legal person is an `individual` or a `corporation`.
  - `latest-risk-rating-url` string — A contextual link to the risk rating.
  - `display-name` string, required — The mutable display name for the Legal-Person
  - `application-status` 'referred' | 'errored' | 'declined' | 'submitted' | 'accepted' — Status of the current [application](/docs/terms/application)
  - `legal-person-status` 'restricted' | 'onboarding-declined' | 'onboarded' | 'verified' | 'onboarding' — Status of the [legal person](#tag/Legal-persons)
  - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
    - string
    - string
  - `legal-person-decisions-url` union, required — Link to [decisions](#tag/Decisions) for this [legal person](/docs/terms/legal-person).
    - string
    - string
  - `status-changed-at` string, date-time — ISO 8601 formatted date-time.
  - `created-at` string, date-time, required — ISO 8601 formatted date-time.
  - `legal-person-claims-url` union — Link to the [claims](#tag/Claims) for this [legal person](/docs/terms/legal-person).
    - string
    - string
  - `legal-person-bank-payees-url` union — Link to the [payees](#tag/Payees) for this [legal person](/docs/terms/legal-person).
    - string
    - string
  - `legal-person-verifications-url` union, required — Link to all [verifications](#tag/Verifications) run against this [legal person](/docs/terms/legal-person).
    - string
    - string
  - `legal-name` string — A read-only, human readable label derived from claims
  - `legal-person-documents-url` union, required — Link to all evidence documents associated with this [legal person](/docs/terms/legal-person).
    - string
    - string

## Other responses

- `400` — Responds with bad-request if the body does not conform to the schema.
- `401` — Requires an API key to continue
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/e56cd4bb9677/schema)