abliteration 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f88d80e1a99e3b8373ec35c02986ed37ccca49626668d3e27bd52bfe405cf8b
-  data.tar.gz: b886954f040d4b73d01c47c54ab53ff3940e6db9d74088bb64c4ba63ae177214
+  metadata.gz: 22dcd3b342509cdc83410548a8f7d6aa975cd5ff6ea8dd7752cdff63a57c15ae
+  data.tar.gz: '083faff3655e6a1721c87f23c92a80f28b3c4565c33f06ba1313af85417345ca'
 SHA512:
-  metadata.gz: e558fb52c8c013629b8e0fbc417b9154383eb560a3091cf4d225b95253051b6030c6d9407e8948840dfd80c1c33a8f91c46f74d96273c333a0e02029b0c74253
-  data.tar.gz: 050e783acb4be82d97a84b64cc9e9677bcd0bae6388e104d92015ac19d8d3540947c953e813e5be9d6ab14a1d8490cf9af1188108278187a05a19adea9d6b013
+  metadata.gz: 67056fce0457a1e0dc6b5ad116b24a9c222622646a205926308af85342d5f5faa15514fd6e66100914add28fc414996a343139e0ad19c50afe8182420a8f7ba1
+  data.tar.gz: 5c1b5586a094f530eaaac3ba39a8af5a5fb156d53871b4a87ca6f1830d23731454775029d6208107bf731cbc5b9ca8591838d422b124ff4c2a93eb4da0b19d67

data/README.md

@@ -97,7 +97,10 @@ Class | Method | HTTP request | Description
 *Abliteration::IndicesApi* | [**list_indices**](docs/IndicesApi.md#list_indices) | **GET** /api/v1/indices | All four indices
 *Abliteration::MethodsApi* | [**get_method**](docs/MethodsApi.md#get_method) | **GET** /api/v1/methods/{id} | Get one method
 *Abliteration::MethodsApi* | [**list_methods**](docs/MethodsApi.md#list_methods) | **GET** /api/v1/methods | List the method taxonomy
+*Abliteration::ModelsApi* | [**get_historical_deletion_summary**](docs/ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary
 *Abliteration::ModelsApi* | [**get_model**](docs/ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model
+*Abliteration::ModelsApi* | [**list_delisted_models**](docs/ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream)
+*Abliteration::ModelsApi* | [**list_historical_deletions**](docs/ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list
 *Abliteration::ModelsApi* | [**list_models**](docs/ModelsApi.md#list_models) | **GET** /api/v1/models | List models
 *Abliteration::TimelineApi* | [**list_timeline**](docs/TimelineApi.md#list_timeline) | **GET** /api/v1/timeline | Curated field events
 
@@ -109,18 +112,26 @@ Class | Method | HTTP request | Description
  - [Abliteration::DaiPoint](docs/DaiPoint.md)
  - [Abliteration::Dataset](docs/Dataset.md)
  - [Abliteration::DatasetDetail](docs/DatasetDetail.md)
+ - [Abliteration::DeletionSummary](docs/DeletionSummary.md)
+ - [Abliteration::DeletionSummaryTimelineInner](docs/DeletionSummaryTimelineInner.md)
+ - [Abliteration::DeletionSummaryTopByDownloadsInner](docs/DeletionSummaryTopByDownloadsInner.md)
+ - [Abliteration::DelistedModel](docs/DelistedModel.md)
  - [Abliteration::Envelope](docs/Envelope.md)
  - [Abliteration::Error](docs/Error.md)
  - [Abliteration::Event](docs/Event.md)
  - [Abliteration::GetAuthor200Response](docs/GetAuthor200Response.md)
  - [Abliteration::GetDataset200Response](docs/GetDataset200Response.md)
+ - [Abliteration::GetHistoricalDeletionSummary200Response](docs/GetHistoricalDeletionSummary200Response.md)
  - [Abliteration::GetIndex200Response](docs/GetIndex200Response.md)
  - [Abliteration::GetMethod200Response](docs/GetMethod200Response.md)
  - [Abliteration::GetModel200Response](docs/GetModel200Response.md)
+ - [Abliteration::HistoricalDeletion](docs/HistoricalDeletion.md)
  - [Abliteration::Index](docs/Index.md)
  - [Abliteration::IndexDetail](docs/IndexDetail.md)
  - [Abliteration::ListAuthors200Response](docs/ListAuthors200Response.md)
  - [Abliteration::ListDatasets200Response](docs/ListDatasets200Response.md)
+ - [Abliteration::ListDelistedModels200Response](docs/ListDelistedModels200Response.md)
+ - [Abliteration::ListHistoricalDeletions200Response](docs/ListHistoricalDeletions200Response.md)
  - [Abliteration::ListIndices200Response](docs/ListIndices200Response.md)
  - [Abliteration::ListMethods200Response](docs/ListMethods200Response.md)
  - [Abliteration::ListModels200Response](docs/ListModels200Response.md)

data/docs/DeletionSummary.md

@@ -0,0 +1,28 @@
+# Abliteration::DeletionSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total_ever_seen** | **Integer** | Live catalog size plus historical deletions. | [optional] |
+| **total_deleted** | **Integer** |  | [optional] |
+| **deletion_rate_pct** | **Float** | Percentage of ever-seen models that are now gone. | [optional] |
+| **avg_months_alive** | **Float** | Average lifespan of deleted models, in months. | [optional] |
+| **timeline** | [**Array<DeletionSummaryTimelineInner>**](DeletionSummaryTimelineInner.md) | Deletions grouped by last_seen_month, ascending. | [optional] |
+| **top_by_downloads** | [**Array<DeletionSummaryTopByDownloadsInner>**](DeletionSummaryTopByDownloadsInner.md) | Top-10 biggest casualties by peak downloads. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummary.new(
+  total_ever_seen: null,
+  total_deleted: null,
+  deletion_rate_pct: null,
+  avg_months_alive: null,
+  timeline: null,
+  top_by_downloads: null
+)
+```
+

data/docs/DeletionSummaryTimelineInner.md

@@ -0,0 +1,20 @@
+# Abliteration::DeletionSummaryTimelineInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **month** | **String** |  | [optional] |
+| **count** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTimelineInner.new(
+  month: null,
+  count: null
+)
+```
+

data/docs/DeletionSummaryTopByDownloadsInner.md

@@ -0,0 +1,24 @@
+# Abliteration::DeletionSummaryTopByDownloadsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **peak_downloads** | **Integer** |  | [optional] |
+| **last_seen_month** | **String** |  | [optional] |
+| **months_alive** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DeletionSummaryTopByDownloadsInner.new(
+  id: null,
+  peak_downloads: null,
+  last_seen_month: null,
+  months_alive: null
+)
+```
+

data/docs/DelistedModel.md

@@ -0,0 +1,30 @@
+# Abliteration::DelistedModel
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **author** | **String** |  | [optional] |
+| **family** | **String** |  | [optional] |
+| **params_b** | **Float** |  | [optional] |
+| **downloads** | **Integer** | Downloads at the moment the model was last visible on HF. Not a live counter. | [optional] |
+| **last_seen_at** | **String** | ISO-8601 timestamp of the last successful Hub observation. Approximately when the model died. | [optional] |
+| **days_since_gone** | **Integer** | Whole days between last_seen_at and now, computed server-side for convenience. | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::DelistedModel.new(
+  id: null,
+  author: null,
+  family: null,
+  params_b: null,
+  downloads: null,
+  last_seen_at: null,
+  days_since_gone: null
+)
+```
+

data/docs/GetHistoricalDeletionSummary200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::GetHistoricalDeletionSummary200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**DeletionSummary**](DeletionSummary.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::GetHistoricalDeletionSummary200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/HistoricalDeletion.md

@@ -0,0 +1,28 @@
+# Abliteration::HistoricalDeletion
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **first_seen_month** | **String** | ISO YYYY-MM of the earliest snapshot the model appears in. | [optional] |
+| **last_seen_month** | **String** | ISO YYYY-MM of the final snapshot before deletion. | [optional] |
+| **total_months_alive** | **Integer** | Whole months between first and last observation. | [optional] |
+| **peak_downloads** | **Integer** | Highest downloads count observed during the model's lifetime. | [optional] |
+| **created_at** | **String** | ISO-8601 timestamp the model was originally created on HF (from the frozen snapshot). | [optional] |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::HistoricalDeletion.new(
+  id: null,
+  first_seen_month: null,
+  last_seen_month: null,
+  total_months_alive: null,
+  peak_downloads: null,
+  created_at: null
+)
+```
+

data/docs/ListDelistedModels200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListDelistedModels200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<DelistedModel>**](DelistedModel.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ListDelistedModels200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/ListHistoricalDeletions200Response.md

@@ -0,0 +1,32 @@
+# Abliteration::ListHistoricalDeletions200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**Array<HistoricalDeletion>**](HistoricalDeletion.md) |  |  |
+| **cost** | **Integer** | Credits this call costs. |  |
+| **credits_remaining** | **Integer** | Wallet balance after the call. Unchanged while metering is preview. |  |
+| **rate_limit_limit** | **Integer** | Ceiling for the current window. Also returned as X-RateLimit-Limit. |  |
+| **rate_limit_remaining** | **Integer** | Calls left in the current window for this key. Also returned as X-RateLimit-Remaining. |  |
+| **rate_limit_reset** | **Integer** | Unix seconds at which the window resets to full ceiling. Also returned as X-RateLimit-Reset. |  |
+| **metering** | **String** | Whether cost was actually deducted. |  |
+| **request_id** | **String** | Also returned in the x-request-id header. |  |
+
+## Example
+
+```ruby
+require 'abliteration'
+
+instance = Abliteration::ListHistoricalDeletions200Response.new(
+  data: null,
+  cost: null,
+  credits_remaining: null,
+  rate_limit_limit: null,
+  rate_limit_remaining: null,
+  rate_limit_reset: null,
+  metering: null,
+  request_id: null
+)
+```
+

data/docs/ModelDetail.md

@@ -26,6 +26,8 @@
 | **last_modified** | **String** |  | [optional] |
 | **first_seen_at** | **String** |  | [optional] |
 | **last_seen_at** | **String** |  | [optional] |
+| **is_delisted** | **Integer** | 0/1 flag. `1` means HF no longer serves this model — the response is the last state we recorded. | [optional] |
+| **days_since_gone** | **Integer** | Whole days between last_seen_at and now. `null` unless is_delisted=1. | [optional] |
 | **readme_text** | **String** |  | [optional] |
 | **readme_status** | **String** |  | [optional] |
 | **tags** | **String** | JSON-encoded array of Hub tags. | [optional] |
@@ -82,6 +84,8 @@ instance = Abliteration::ModelDetail.new(
   last_modified: null,
   first_seen_at: null,
   last_seen_at: null,
+  is_delisted: null,
+  days_since_gone: null,
   readme_text: null,
   readme_status: null,
   tags: null,

data/docs/ModelSummary.md

@@ -17,6 +17,8 @@
 | **is_gguf** | **Integer** |  | [optional] |
 | **created_at** | **String** |  | [optional] |
 | **first_seen_at** | **String** |  | [optional] |
+| **is_delisted** | **Integer** | 0/1 flag, present in every response row. `1` means the model is no longer on the Hub. | [optional] |
+| **last_seen_at** | **String** | ISO-8601 timestamp of the last successful Hub observation. Non-null on delisted rows. | [optional] |
 
 ## Example
 
@@ -36,7 +38,9 @@ instance = Abliteration::ModelSummary.new(
   likes: null,
   is_gguf: null,
   created_at: null,
-  first_seen_at: null
+  first_seen_at: null,
+  is_delisted: null,
+  last_seen_at: null
 )
 ```
 

data/docs/ModelsApi.md

@@ -4,17 +4,86 @@ All URIs are relative to *https://abliteration.org*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**get_historical_deletion_summary**](ModelsApi.md#get_historical_deletion_summary) | **GET** /api/v1/models/historical-deletions/summary | Historical deletions — aggregate summary |
 | [**get_model**](ModelsApi.md#get_model) | **GET** /api/v1/models/{id} | Get one model |
+| [**list_delisted_models**](ModelsApi.md#list_delisted_models) | **GET** /api/v1/models/delisted | List delisted models (change stream) |
+| [**list_historical_deletions**](ModelsApi.md#list_historical_deletions) | **GET** /api/v1/models/historical-deletions/list | Historical deletions — paged list |
 | [**list_models**](ModelsApi.md#list_models) | **GET** /api/v1/models | List models |
 
 
+## get_historical_deletion_summary
+
+> <GetHistoricalDeletionSummary200Response> get_historical_deletion_summary
+
+Historical deletions — aggregate summary
+
+Cost: 20 credits, flat. Aggregates from the 24-month HF snapshot analysis: total ever seen, total deleted, deletion rate, average months alive, monthly timeline of losses, top-10 by peak downloads. One call replaces half a dozen separate queries.
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+
+begin
+  # Historical deletions — aggregate summary
+  result = api_instance.get_historical_deletion_summary
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary: #{e}"
+end
+```
+
+#### Using the get_historical_deletion_summary_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetHistoricalDeletionSummary200Response>, Integer, Hash)> get_historical_deletion_summary_with_http_info
+
+```ruby
+begin
+  # Historical deletions — aggregate summary
+  data, status_code, headers = api_instance.get_historical_deletion_summary_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetHistoricalDeletionSummary200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->get_historical_deletion_summary_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetHistoricalDeletionSummary200Response**](GetHistoricalDeletionSummary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_model
 
 > <GetModel200Response> get_model(id)
 
 Get one model
 
-Cost: 10 credits. Priced above /authors/[id], /methods/[id] and /datasets/[id] because iterating over model ids is functionally a slow dump. The id is author/name and must be percent-encoded.
+Cost: 10 credits. Priced above /authors/[id], /methods/[id] and /datasets/[id] because iterating over model ids is functionally a slow dump. The id is author/name and must be percent-encoded. Delisted models are served here even though they are hidden from the default catalog list; the response then carries `is_delisted=1` and `days_since_gone`.
 
 ### Examples
 
@@ -77,13 +146,169 @@ end
 - **Accept**: application/json
 
 
+## list_delisted_models
+
+> <ListDelistedModels200Response> list_delisted_models(opts)
+
+List delisted models (change stream)
+
+Cost: 5 credits, flat. Change-stream companion to /models: every row is a tombstone — a model that HF no longer serves, preserved here at its final state. Poll with `since=<last_seen_at of your previous run>` to fetch only new casualties; callers building compliance dashboards, safety-research corpora, or \"wayback\" tools live on this endpoint. See /api#change-stream.
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+opts = {
+  since: 'since_example', # String | ISO-8601 date or timestamp. Rows with last_seen_at >= since only. Use your previous poll's newest last_seen_at to build an incremental feed.
+  sort: 'recent', # String | `recent` (default, newest disappearance first) or `downloads` (biggest casualties first — best for post-mortem coverage).
+  limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+  offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
+}
+
+begin
+  # List delisted models (change stream)
+  result = api_instance.list_delisted_models(opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_delisted_models: #{e}"
+end
+```
+
+#### Using the list_delisted_models_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListDelistedModels200Response>, Integer, Hash)> list_delisted_models_with_http_info(opts)
+
+```ruby
+begin
+  # List delisted models (change stream)
+  data, status_code, headers = api_instance.list_delisted_models_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListDelistedModels200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_delisted_models_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **since** | **String** | ISO-8601 date or timestamp. Rows with last_seen_at &gt;&#x3D; since only. Use your previous poll&#39;s newest last_seen_at to build an incremental feed. | [optional] |
+| **sort** | **String** | &#x60;recent&#x60; (default, newest disappearance first) or &#x60;downloads&#x60; (biggest casualties first — best for post-mortem coverage). | [optional][default to &#39;recent&#39;] |
+| **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
+| **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |
+
+### Return type
+
+[**ListDelistedModels200Response**](ListDelistedModels200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_historical_deletions
+
+> <ListHistoricalDeletions200Response> list_historical_deletions(opts)
+
+Historical deletions — paged list
+
+Cost: 5 credits, flat. Paged/filterable window on the 24-month deletion backlog. Rows are frozen at the moment the model was last seen on the Hub — peak_downloads and total_months_alive never change after death. Sort by size (`downloads`, default), recency (`recent`, newest deaths first) or lifespan (`lifespan`, longest-lived first — surprising deaths).
+
+### Examples
+
+```ruby
+require 'time'
+require 'abliteration'
+# setup authorization
+Abliteration.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Abliteration::ModelsApi.new
+opts = {
+  since_month: 'since_month_example', # String | ISO YYYY-MM. Rows with last_seen_month >= it only.
+  min_peak_downloads: 56, # Integer | Only rows whose peak downloads >= this. `casualties over N` queries.
+  sort: 'downloads', # String | `downloads` (default, biggest first), `recent` (newest last_seen_month first), `lifespan` (longest-lived first).
+  limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+  offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
+}
+
+begin
+  # Historical deletions — paged list
+  result = api_instance.list_historical_deletions(opts)
+  p result
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions: #{e}"
+end
+```
+
+#### Using the list_historical_deletions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListHistoricalDeletions200Response>, Integer, Hash)> list_historical_deletions_with_http_info(opts)
+
+```ruby
+begin
+  # Historical deletions — paged list
+  data, status_code, headers = api_instance.list_historical_deletions_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListHistoricalDeletions200Response>
+rescue Abliteration::ApiError => e
+  puts "Error when calling ModelsApi->list_historical_deletions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **since_month** | **String** | ISO YYYY-MM. Rows with last_seen_month &gt;&#x3D; it only. | [optional] |
+| **min_peak_downloads** | **Integer** | Only rows whose peak downloads &gt;&#x3D; this. &#x60;casualties over N&#x60; queries. | [optional] |
+| **sort** | **String** | &#x60;downloads&#x60; (default, biggest first), &#x60;recent&#x60; (newest last_seen_month first), &#x60;lifespan&#x60; (longest-lived first). | [optional][default to &#39;downloads&#39;] |
+| **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
+| **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |
+
+### Return type
+
+[**ListHistoricalDeletions200Response**](ListHistoricalDeletions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_models
 
 > <ListModels200Response> list_models(opts)
 
 List models
 
-Cost: 5-300+ credits, stepped by returned rows and multiplied by `1 + (offset/2500)²`. A filtered lookup up to 200 rows costs 5; a 1000-row page on the first page costs 300; on offset=10000, 5100. Filter cheap, dump expensive. See /api#pricing. Delisted models are excluded here but remain reachable by id.
+Cost: 5-300+ credits, stepped by returned rows and multiplied by `1 + (offset/2500)²`. A filtered lookup up to 200 rows costs 5; a 1000-row page on the first page costs 300; on offset=10000, 5100. Filter cheap, dump expensive. See /api#pricing. Delisted models are excluded by default (`delisted=live`); pass `delisted=dead|all` to include tombstoned records. A dedicated change-stream endpoint is at GET /api/v1/models/delisted.
 
 ### Examples
 
@@ -106,6 +331,7 @@ opts = {
   downloads_lte: 56, # Integer | 
   created_after: 'created_after_example', # String | ISO-8601 date or timestamp, inclusive.
   created_before: 'created_before_example', # String | ISO-8601 date or timestamp, inclusive.
+  delisted: 'live', # String | Tombstone filter. `live` (default): HF-visible models only. `dead`: delisted-only (same shape as this endpoint plus is_delisted=1 and last_seen_at). `all`: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted.
   sort: 'downloads', # String | Bare key is the natural direction (downloads/likes = most first, dates = newest first). A leading `-` flips it. `created` and `first_seen` are aliases for the full column names.
   limit: 56, # Integer | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
   offset: 56 # Integer | Rows to skip. Negative and non-numeric values are treated as 0.
@@ -150,6 +376,7 @@ end
 | **downloads_lte** | **Integer** |  | [optional] |
 | **created_after** | **String** | ISO-8601 date or timestamp, inclusive. | [optional] |
 | **created_before** | **String** | ISO-8601 date or timestamp, inclusive. | [optional] |
+| **delisted** | **String** | Tombstone filter. &#x60;live&#x60; (default): HF-visible models only. &#x60;dead&#x60;: delisted-only (same shape as this endpoint plus is_delisted&#x3D;1 and last_seen_at). &#x60;all&#x60;: both, in one page. For a purpose-built change-stream feed, prefer GET /api/v1/models/delisted. | [optional][default to &#39;live&#39;] |
 | **sort** | **String** | Bare key is the natural direction (downloads/likes &#x3D; most first, dates &#x3D; newest first). A leading &#x60;-&#x60; flips it. &#x60;created&#x60; and &#x60;first_seen&#x60; are aliases for the full column names. | [optional][default to &#39;downloads&#39;] |
 | **limit** | **Integer** | Rows to return, 1 to 1000. Values outside the range are clamped, not rejected. | [optional][default to 50] |
 | **offset** | **Integer** | Rows to skip. Negative and non-numeric values are treated as 0. | [optional][default to 0] |