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>

{
  "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

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

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"],
});

JavaScript SDK

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

updateContact(request: UpdateContactRequest): Promise<UpdateContactResponse>
updateContactWithApproval(request: UpdateContactRequest): Promise<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>

{
  "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>

{
  "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

JavaScript SDK

​Path parameters

​Request body

​Response

​Approve the update

​JavaScript SDK

Path parameters

Request body

Response

Approve the update

JavaScript SDK