screening

Tag the flagged listings, and hold the confident ones in draft

Writes the verdicts as terms in the review taxonomy, creating the taxonomy and only the terms actually earned.

Additive. Terms are written directly, so a listing’s services, industries and regions are untouchable by this endpoint — unlike PUT .../terms, which is replace-all.

Self-correcting. A screening term that no longer applies is removed, so a site that comes back stops being tagged as dead. Only the four screening terms are ever removed; your own review tags are never touched.

It never re-publishes. site-dead, site-parked and site-placeholder pull a published listing back to draft. Nothing puts it back — a listing may have been edited or merged since, and silently re-publishing is a change nobody asked for. Pass hold: false for a tag-only pass.

Send dryRun: true to see the counts without writing. It previews both halves — wouldTag/wouldHold for what would be added, wouldClear for what would be removed. Watch wouldClear: clearing recovered listings is uncapped and is not drawn from the capped selection, so a converged directory can preview zero tags and still have removals pending.

post/v1/directories/{directoryId}/screening/apply

Request

  • Base URL: https://api.epicdirectories.com
  • URL: https://api.epicdirectories.com/v1/directories/{directoryId}/screening/apply
  • Auth: HTTP bearer

Path parameters

directoryIdstring required

Request body

dryRunboolean

Report what would change and write nothing. The counts are computed by the same code path that does the writing, so a dry run cannot disagree with the real one.

holdboolean

Pull flagged listings back to draft as well as tagging them. On by default: which verdicts unpublish is a property of the policy, not of the caller. Set false for a tag-only pass when you want to read the queue before anything leaves the directory.

limitnumber

How many listings to act on, capped at 2000. The response reports deferred when the cap bit rather than implying full coverage.

Response

Counts of what changed

Changes

No recorded changes to this operation across all 1 revision of this API.