---
title: "Rename a treasury contact"
method: PATCH
path: "/v1/multisig-wallets/{walletId}/contacts/{contactId}"
tags: ["Multisig Wallets"]
---

# Rename a treasury contact

`PATCH /v1/multisig-wallets/{walletId}/contacts/{contactId}`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/multisig-wallets/{walletId}/contacts/{contactId}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

Change the name of a destination. The ADDRESS is immutable by design: redirecting a name that signers have come to trust is the very attack the address book exists against. Archive the contact and add a new one.

## Path parameters

- `walletId` string, uuid, required
- `contactId` string, uuid, required

## Request body

- RenameMultisigContactDto
  - `label` string, required: Name to give this destination.

## Response `200`

Contact renamed

- MultisigContactDtoOutput
  - `id` string, uuid, required: Entity UUID
  - `createdAt` string, date-time, required: Creation date (ISO 8601)
  - `updatedAt` string, date-time, required: Last update date (ISO 8601)
  - `label` string, required: Name a signer gave this destination. What one picks in the transfer form, and what the signer app shows instead of a bare address.
  - `address` string, required: Destination address, 0x-prefixed 20 bytes. Stored lowercase; a mixed-case input has its EIP-55 checksum verified on the way in.
  - `archivedAt` string, date-time, nullable, required: When the contact was retired. An archived contact can no longer receive a transfer, but still names the past transfers that went to it. Null while it stands.
  - `lastUsedAt` string, date-time, nullable, required: When a transfer to this contact last EXECUTED — never when one was merely opened, so a cancelled transfer does not make an address look familiar. Null means never used, which the signer app calls out.

## Other responses

- `403`: Session-authenticated signer of this treasury required
- `422`: No live contact with this id on this treasury

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)