Skip to main content
DELETE
Remove a key result
Deletes a key result permanently, as the Console does. This cannot be undone. Send { "id": "..." }; an unknown or malformed id is 404 resource_missing and omitting it is 400 bad_request, so repeating a completed removal without an Idempotency-Key answers 404. The credential needs both the objectives:read and objectives:manage scopes, and objectives:read and objectives:manage granted at the deployment root; otherwise 403 permission_denied names the missing permission. The body is strict: unknown fields are 400 bad_request. Success is 200 with { "id": "...", "removed": true }. A same-key retry within 24 hours returns that acknowledgement while the caller still holds both permissions at the deployment root.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

keyResultId
string
required

The key result ID, as the objective reads return it.

Minimum string length: 1

Response

Remove a key result

data
object
required

Acknowledges a permanently deleted key result.

meta
object
required