---
title: "Delete a score definition"
method: DELETE
path: "/api/v1/ackdb/scores/{scoreKey}"
tags: ["ackDB"]
---

# Delete a score definition

`DELETE /api/v1/ackdb/scores/{scoreKey}`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/scores/{scoreKey}`
- Auth: HTTP bearer

Hard delete + transactional scrub of every saved segment referencing the score's columns (filters, sort, columns) — referencing views degrade gracefully instead of 400ing. Nothing is stored per record, so there is no other cleanup.

## Path parameters

- `scoreKey` string, required

## Query parameters

- `grain` 'company' | 'person'

## Response `200`

Deletion result.

- object
  - `deleted` boolean, required
  - `scrubbedSegments` integer, required: Saved segments rewritten by the scrub.

## Other responses

- `404`: No such definition.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)