# 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: 54e9a006
Security: CodeBearer

## Security:

  - `CodeBearer` (unknown)
    oauth2 scopes: customer.write

## 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 202:

  - `202` (unknown)
    Successful Response

## Response 422:

  - `422` (unknown)
    Validation Error

## 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)