> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Cardholder

> Update the company's virtual card cardholder

Updates the existing cardholder profile. All fields are optional — only provided fields will be updated.

### 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` |

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  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"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "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"
    }
  }
  ```
</ResponseExample>

## CLI

```bash theme={"theme":"css-variables"}
naive cards update-cardholder
```

The CLI will prompt for fields to update interactively.

## MCP

Tool: `naive_cards_update_cardholder`

```json theme={"theme":"css-variables"}
{
  "billingLine1": "456 Market St",
  "billingCity": "San Francisco",
  "billingPostalCode": "94107"
}
```