Skip to main content
PATCH
/
api
/
v1
/
user
/
contacts
/
{contact_id}
Update contact name
curl --request PATCH \
  --url https://api.hevn.finance/api/v1/user/contacts/{contact_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "walletAddress": "<string>",
  "chainId": "<string>",
  "currency": "<string>",
  "address": {
    "streetAddress": "<string>",
    "addressLine2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>"
  }
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
default:Bearer <token>
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-api-key
string | null

Path Parameters

contact_id
string<uuid>
required

Body

application/json

Request to update a contact.

name
string | null
Required string length: 1 - 200
userId
string<uuid> | null
walletAddress
string | null
chainId
string | null
currency
string | null
Required string length: 3
priorityMethod
enum<string> | null

Transaction type - payment rail.

Includes all FiatPaymentType values (sepa/swift/ach/uaefts) plus extended fiat variants (wire/swift-usd/swift-eur/fedwire/pix) and non-fiat rails (crypto/card/internal/refund).

Available options:
sepa,
swift,
ach,
uaefts,
fedwire,
swift-usd,
swift-eur,
wire,
pix,
crypto,
card,
internal,
refund
address
UserAddress · object

Address schema for user.

Canonical field names: street_address, address_line_2, city, state, country, zip. Accepts legacy Align/IBAN field names (street_line_1, street_line_2, postal_code) for backward compatibility with existing JSONB data.

relationship
enum<string> | null

Relationship between the current user and the contact.

Available options:
self,
external

Response

Successful Response