Cards
Update Cardholder
Update the company’s virtual card cardholder
PATCH
/
v1
/
cards
/
cardholder
curl -X PATCH https://api.usenaive.ai/v1/cards/cardholder \
-H "Authorization: Bearer nv_sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107"
}'
{
"cardholder": {
"id": "ich_1abc123",
"firstName": "John",
"lastName": "Doe",
"email": "john@acme.com",
"phone": "+14155551234",
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107",
"billingCountry": "US",
"type": "individual",
"status": "active",
"created_at": "2026-01-20T08:30:00Z"
}
}
Updates the existing cardholder profile. All fields are optional — only provided fields will be updated.
The CLI will prompt for fields to update interactively.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
firstName | string | No | Cardholder’s first name |
lastName | string | No | Cardholder’s last name |
billingLine1 | string | No | Billing address line 1 |
billingCity | string | No | Billing city |
billingState | string | No | Billing state (2-letter code) |
billingPostalCode | string | No | Billing postal/ZIP code |
billingCountry | string | No | Billing country (2-letter ISO code) |
email | string | No | Cardholder’s email address |
phone | string | No | Cardholder’s phone number |
type | string | No | Cardholder type: individual or company |
curl -X PATCH https://api.usenaive.ai/v1/cards/cardholder \
-H "Authorization: Bearer nv_sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107"
}'
{
"cardholder": {
"id": "ich_1abc123",
"firstName": "John",
"lastName": "Doe",
"email": "john@acme.com",
"phone": "+14155551234",
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107",
"billingCountry": "US",
"type": "individual",
"status": "active",
"created_at": "2026-01-20T08:30:00Z"
}
}
CLI
naive cards update-cardholder
MCP
Tool:naive_cards_update_cardholder
{
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingPostalCode": "94107"
}
⌘I
curl -X PATCH https://api.usenaive.ai/v1/cards/cardholder \
-H "Authorization: Bearer nv_sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107"
}'
{
"cardholder": {
"id": "ich_1abc123",
"firstName": "John",
"lastName": "Doe",
"email": "john@acme.com",
"phone": "+14155551234",
"billingLine1": "456 Market St",
"billingCity": "San Francisco",
"billingState": "CA",
"billingPostalCode": "94107",
"billingCountry": "US",
"type": "individual",
"status": "active",
"created_at": "2026-01-20T08:30:00Z"
}
}