v5
latestOpenAPI 3.1.02026-08-025631,1012.8 MBPublished 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