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

# ProjectKPIs.update

`PATCH /entities/ProjectKPIs/{id}`

Modifies ProjectKPI or ProjectKPIs with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateProjectKPIInput
  - `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 — KPI metric this event represents: ProjectCompleted. Integer enum value: 1 - ProjectCompleted
  - `owner_id` string, uuid — Id of the project owner at the time of the event.
  - `project_id` string, uuid — Id of the project.
  - `unit_id` string, uuid — Id of the sales unit.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting ProjectKPI

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` ProjectKPI
    - `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 (project completion). 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 — Project 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.
    - `project` string, uri, required — Project this KPI event relates to. Relation to Project. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Project' 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.
    - `kpi` 1, required — KPI metric this event represents: ProjectCompleted. Integer enum value: 1 - ProjectCompleted
    - `owner_id` string, uuid, required — Id of the project owner at the time of the event.
    - `project_id` string, uuid, required — Id of the project.
    - `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)