v51

OpenAPI 3.1.0raw.githubusercontent.com2026-08-018486293.2 KB
usage

Delete Usage Rows

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/v1/usage

Request body

api_key_idstring nullable
by_filterboolean
end_datestring date-time nullable
endpointstring nullable
idsstring[] nullable
modelstring nullable
pricedboolean nullable
sourcestring nullable
start_datestring date-time nullable
statusstring nullable
user_idstring nullable

Response

Successful Response

deletedinteger