---
title: "ContactKPIs.update"
method: PATCH
path: "/entities/ContactKPIs/{id}"
tags: ["Contact"]
---

# ContactKPIs.update

`PATCH /entities/ContactKPIs/{id}`

Modifies ContactKPI or ContactKPIs with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateContactKPIInput
  - `application_id` string, uuid — Application context in which the KPI event was triggered (e.g. browser, automation, third-party integration).
  - `client_id` string, uuid — Id of the user who triggered the event.
  - `contact_id` string, uuid — Id of the contact.
  - `kpi` 1 | 2 | 3 | 4 — KPI metric this event represents: CreateContact, FirstEmailSent, LastEmailSent, Archive. Integer enum value: 1 - CreateContact, 2 - LastEmailSent, 3 - FirstEmailSent, 4 - Archive
  - `owner_id` string, uuid — Id of the contact owner at the time of the event.
  - `unit_id` string, uuid — Id of the sales unit.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting ContactKPI

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` ContactKPI
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `client` string, uri — User who triggered the KPI event (e.g. created or archived the contact, sent the first email). Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties.
    - `contact` string, uri, required — Contact this KPI event relates to. Relation to Contact. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Contact' object for properties.
    - `owner` string, uri, required — Contact owner at the time the KPI event occurred. Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties.
    - `unit` string, uri — Sales unit the triggering user belonged to at the time of the event. Relation to SalesUnit. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'SalesUnit' object for properties.
    - `application_id` string, uuid — Application context in which the KPI event was triggered (e.g. browser, automation, third-party integration).
    - `client_id` string, uuid — Id of the user who triggered the event.
    - `contact_id` string, uuid, required — Id of the contact.
    - `kpi` 1 | 2 | 3 | 4, required — KPI metric this event represents: CreateContact, FirstEmailSent, LastEmailSent, Archive. Integer enum value: 1 - CreateContact, 2 - LastEmailSent, 3 - FirstEmailSent, 4 - Archive
    - `owner_id` string, uuid, required — Id of the contact owner at the time of the event.
    - `unit_id` string, uuid — Id of the sales unit.
    - `revision` integer — Revision when entity was lastly changed.

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/versions/e8c12ae60aca/schema)