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

# AccountKPIs.update

`PATCH /entities/AccountKPIs/{id}`

Modifies AccountKPI or AccountKPIs with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateAccountKPIInput
  - `account_id` string, uuid — Id of the account.
  - `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.
  - `kpi` 1 | 2 | 3 | 4 — KPI metric this event represents: CreateAccount, FirstEmailSent, LastEmailSent, Archive. Integer enum value: 1 - CreateAccount, 2 - LastEmailSent, 3 - FirstEmailSent, 4 - Archive
  - `owner_id` string, uuid — Id of the account 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 AccountKPI

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` AccountKPI
    - `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.
    - `account` string, uri, required — Account this KPI event relates to. Relation to Account. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Account' object for properties.
    - `client` string, uri — User who triggered the KPI event (e.g. created or archived the account, 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.
    - `owner` string, uri, required — Account 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.
    - `account_id` string, uuid, required — Id of the account.
    - `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.
    - `kpi` 1 | 2 | 3 | 4, required — KPI metric this event represents: CreateAccount, FirstEmailSent, LastEmailSent, Archive. Integer enum value: 1 - CreateAccount, 2 - LastEmailSent, 3 - FirstEmailSent, 4 - Archive
    - `owner_id` string, uuid, required — Id of the account 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)