# Update Counterparty

This endpoint is used to update a counterparty. For example, you can use it to unlink a counterparty that is no longer needed, or to set or change its display_name.

The request body takes an UpdateCounterpartyRequest object. On success, it returns the updated counterparty object.

Endpoint: PATCH /api/v2/counterparties/{counterparty_id}/
Version: Version: 0b8bd2e8
Security: CodeBearer

## Path parameters:

  - `counterparty_id` (string, required)

## Request fields (application/json):

  - `status` (any)

  - `display_name` (any)
    An optional custom display name for the counterparty, useful for distinguishing multiple counterparties that share the same legal name.

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)