Skip to main content
DELETE
Delete KPI

Delete KPI

Remove a KPI definition from a dataset. This only works if no values have been submitted for this KPI.
This action cannot be undone. If the KPI has submitted values, the API returns 409 Conflict.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the parent dataset
string
required
UUID of the KPI to delete

Response

Returns HTTP 204 No Content on success.

Example

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

404 Not Found

Cause: KPI not found

409 Conflict

Cause: KPI has submitted values The KPI has submitted values and cannot be deleted.

Create KPI

Add a new KPI to the dataset

Get Dataset

View the dataset with all its KPIs