---
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}`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/legal-persons/{legal-person-id}`
- Auth: API key in header `Authorization`

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

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `put-legal-persons-legal-person-id` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/legal-persons/:legal-person-id/put.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)