Update a Contact

REST request body

{
  "assetList": ["USDC"],
  "contactGroupIds": ["contact_group_123"]
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request PUT \
  --url "https://api.primevault.com/api/external/contacts/contact_123/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "assetList": ["USDC"],
    "contactGroupIds": ["contact_group_123"]
  }'

interface UpdateContactRequest {
  id: string;
  assetList?: string[];
  contactGroupIds?: string[];
}

updateContact(request: UpdateContactRequest): Promise<UpdateContactResponse>
updateContactWithApproval(request: UpdateContactRequest): Promise<Contact>

Response example

{
  "id": "contact_123",
  "name": "Operations Wallet",
  "address": "0xAbC1234567890abcdef1234567890abcdef1234",
  "blockChain": "ETHEREUM",
  "tags": [
    "vendor",
    "priority"
  ],
  "externalId": "vendor-1001",
  "assetList": [
    "USDC"
  ]
}

PUT /api/external/contacts/{contactId}/

The current SDK update contract changes only assetList and contactGroupIds. It does not rename the contact or replace its address.

Path parameters

string

required

The unique contact identifier.

Request body

string[]

Assets permitted for the contact.

string[]

Organization-scoped contact groups to attach.

Response

Returns the updated contact’s identifying fields, a subset of Contact.

string

Contact ID.

string

Contact display name.

string

Blockchain address.

string

Chain of the address.

string[]

Searchable contact tags.

string

Your own reference, if you set one.

string[]

Assets permitted for the contact.

Approve the update

Updating a contact opens a change request that your API user must approve. Call Get Approval Message with entityId set to the contact id, sign the message, and send the signature to Submit Approval Action. See Approvals for the full flow. With the SDK, updateContactWithApproval() updates and approves in one call, then returns the contact:

const contact = await apiClient.updateContactWithApproval({
  id: "contact_123",
  assetList: ["USDC"],
});

REST request body

{
  "assetList": ["USDC"],
  "contactGroupIds": ["contact_group_123"]
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request PUT \
  --url "https://api.primevault.com/api/external/contacts/contact_123/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "assetList": ["USDC"],
    "contactGroupIds": ["contact_group_123"]
  }'

interface UpdateContactRequest {
  id: string;
  assetList?: string[];
  contactGroupIds?: string[];
}

updateContact(request: UpdateContactRequest): Promise<UpdateContactResponse>
updateContactWithApproval(request: UpdateContactRequest): Promise<Contact>

Response example

{
  "id": "contact_123",
  "name": "Operations Wallet",
  "address": "0xAbC1234567890abcdef1234567890abcdef1234",
  "blockChain": "ETHEREUM",
  "tags": [
    "vendor",
    "priority"
  ],
  "externalId": "vendor-1001",
  "assetList": [
    "USDC"
  ]
}

⌘I

REST request body

{
  "assetList": ["USDC"],
  "contactGroupIds": ["contact_group_123"]
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request PUT \
  --url "https://api.primevault.com/api/external/contacts/contact_123/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "assetList": ["USDC"],
    "contactGroupIds": ["contact_group_123"]
  }'

interface UpdateContactRequest {
  id: string;
  assetList?: string[];
  contactGroupIds?: string[];
}

updateContact(request: UpdateContactRequest): Promise<UpdateContactResponse>
updateContactWithApproval(request: UpdateContactRequest): Promise<Contact>

Response example

{
  "id": "contact_123",
  "name": "Operations Wallet",
  "address": "0xAbC1234567890abcdef1234567890abcdef1234",
  "blockChain": "ETHEREUM",
  "tags": [
    "vendor",
    "priority"
  ],
  "externalId": "vendor-1001",
  "assetList": [
    "USDC"
  ]
}

API Basics

Approvals

Accounts

Sub-Orgs

Transactions

Path parameters

Request body

Response

Approve the update

​Path parameters

​Request body

​Response

​Approve the update

Path parameters

Request body

Response

Approve the update