Sign in
usage

Delete Usage Rows

Changed on

Delete imported usage rows by explicit ids or by filter (standalone).

Target either the current selection (ids) or everything matching a filter (by_filter: true plus optional source / model / user_id / status / date range / priced). Only imported rows (counts_toward_budget = false) are ever removed: enforced gateway rows and the spend ledger (users.spend) are untouched, so a delete can never desync a budget. Master-key only.

delete/api/v1/usage

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Request body

by_filterboolean
end_datestring date-time nullable
endpointstring nullable
idsstring[] nullable
pricedboolean nullable
providerstring nullable
sourcestring nullable
source_labelstring nullable
start_datestring date-time nullable
statusstring nullable
toolstring nullable
workspace_idstring uuid nullable

Response

Successful Response

deletedinteger

Changes