Replace a contact

PUT/api/v1/mailbox/address-book/contacts/{card_id}

Requires amailbox token— it acts as one mailbox holder, not as the organization.

etag is the copy the caller last read.

Without it, two devices editing the same contact end with one silently overwriting the other. With it the second write is refused and the client can re-read -- the same contract the calendar's event update uses.

Parameters

Name	In	Type
`card_id`required	path	string
`etag`	query	string
`book`	query	string

Request body

Request

PUT/api/v1/mailbox/address-book/contacts/{card_id}

curl -X PUT 'https://app.mailyte.com/api/v1/mailbox/address-book/contacts/01JBT8XQ2M9WYC3K4F6R7S8T9V' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

const response = await fetch('https://app.mailyte.com/api/v1/mailbox/address-book/contacts/01JBT8XQ2M9WYC3K4F6R7S8T9V', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer MAILBOX_TOKEN',
  },
});
const { data } = await response.json();

import requests
response = requests.put(
    "https://app.mailyte.com/api/v1/mailbox/address-book/contacts/01JBT8XQ2M9WYC3K4F6R7S8T9V",
    headers={"Authorization": "Bearer MAILBOX_TOKEN"},
)
data = response.json()["data"]

<?php

$response = Http::withToken('MAILBOX_TOKEN')
    ->put('https://app.mailyte.com/api/v1/mailbox/address-book/contacts/01JBT8XQ2M9WYC3K4F6R7S8T9V');

$data = $response->json('data');

require "net/http"
require "json"
uri = URI("https://app.mailyte.com/api/v1/mailbox/address-book/contacts/01JBT8XQ2M9WYC3K4F6R7S8T9V")
request = Net::HTTP::Put.new(uri)
request["Authorization"] = "Bearer MAILBOX_TOKEN"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

The key names its own organization, so no X-Organization-ID header is needed.

Response

Successful Response

Returned inside the standard envelope.

Errors

Status	When
`422`	Validation Error

Every status, with what causes it and what to do, is on the error reference.