v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Published Retrievers

Reconcile Publish State

Repair published_retrievers <-> marketplace_listings divergence (BACKE-743).

A retriever's public surfaces can drift apart — e.g. a marketplace listing exists but its published_retrievers record is missing, so /v1/public/retrievers/{name} 404s (half-published). This detects the state and (unless dry_run) repairs it idempotently:

  • missing_published -> create the published record from the listing (reused id)
  • missing_listing -> create the listing from the published record
  • consistent -> ensure cross-link
  • not_published -> no-op
post/v1/retrievers/{retriever_id}/publish/reconcile

Path parameters

retriever_idstring required

ID of the retriever to reconcile

ID of the retriever to reconcile

Query parameters

dry_runboolean

Report the divergence state without mutating

Report the divergence state without mutating

Response

Successful Response

object required