Skip to main content
PATCH
/
api
/
v1
/
cardholders
/
{id}
curl -X PATCH https://api.agentcard.sh/api/v1/cardholders/ch_abc123 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+1-555-0100"}'

{
  "id": "ch_abc123",
  "firstName": "Alice",
  "lastName": "Smith",
  "email": "alice@example.com",
  "dateOfBirth": "1990-01-15T00:00:00.000Z",
  "phoneNumber": "+1-555-0100",
  "createdAt": "2026-03-10T12:00:00.000Z",
  "updatedAt": "2026-03-10T12:05:00.000Z"
}
Updates a cardholder’s information. Only the fields you include in the request body will be changed.

​
Path parameters

​
id
string
required
The cardholder’s unique identifier.

​
Request body

​
firstName
string
Cardholder’s first name.
​
lastName
string
Cardholder’s last name.
​
email
string
Cardholder’s email address.
​
dateOfBirth
string
Date of birth in YYYY-MM-DD format.
​
phoneNumber
string
Cardholder’s phone number.

​
Response

​
id
string
Unique cardholder identifier.
​
firstName
string
Cardholder’s first name.
​
lastName
string
Cardholder’s last name.
​
email
string
Cardholder’s email address, if provided.
​
dateOfBirth
string
Date of birth, if provided.
​
phoneNumber
string
Phone number, if provided.
​
createdAt
string
ISO 8601 creation timestamp.
​
updatedAt
string
ISO 8601 last-updated timestamp.
curl -X PATCH https://api.agentcard.sh/api/v1/cardholders/ch_abc123 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+1-555-0100"}'

{
  "id": "ch_abc123",
  "firstName": "Alice",
  "lastName": "Smith",
  "email": "alice@example.com",
  "dateOfBirth": "1990-01-15T00:00:00.000Z",
  "phoneNumber": "+1-555-0100",
  "createdAt": "2026-03-10T12:00:00.000Z",
  "updatedAt": "2026-03-10T12:05:00.000Z"
}