---
title: "Edit contact card"
method: POST
path: "/v1/contacts/{id}/card"
tags: ["Owner"]
---

# Edit contact card

`POST /v1/contacts/{id}/card`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/contacts/{id}/card`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- EditContactCardRequest
  - `field` 'who' | 'usual' | 'bestTime' | 'language' | 'note', required
  - `action` 'confirm' | 'edit' | 'remove', required
  - `value` string

## Response `200`

OK

- ContactCardResponse
  - `contactId` string, required
  - `nameSource` 'owner' | 'they_said', required
  - `saidName` string, nullable, required
  - `listingName` string, nullable, required
  - `who` object, nullable, required
    - `text` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
    - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
  - `usual` object, nullable, required
    - `text` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
    - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
  - `topics` object[], required
    - `topic` 'books' | 'callBack' | 'message' | 'asks' | 'texts' | 'emails', required
    - `count` integer, required
  - `bestTime` object, nullable, required
    - `days` 'weekdays' | 'weekends' | 'any', required
    - `from` integer, required
    - `to` integer, required
    - `samples` number, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
  - `language` object, nullable, required
    - `code` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
  - `note` string, nullable, required
  - `promises` object[], required
    - `id` string, required
    - `who` 'owner' | 'caller', required
    - `text` string, required
    - `dueAt` string, date-time, required
    - `interactionId` string, required
  - `counts` object, required
    - `calls` integer, required
    - `texts` integer, required
    - `emails` integer, required
    - `bookings` integer, required
    - `errands` integer, required
  - `firstAt` string, date-time, required
  - `lastAt` string, date-time, required
  - `built` boolean, required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `404`: No such resource, or not visible to this caller.
- `413`: Body over the limit (64 KB; 512 KB for contact import).
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)