Decides the fate of a listing in the queue: approve, hide or block.

A submitter with an account gets one e-mail per decision (the decision, the reason and the page or the receipt); repeating the same state sends nothing. A guest or agent owner has no e-mail and polls GET /api/listings/:id/status. Returns: { ok, status, reason }

post/api/admin/listings/{id}

Request

  • Base URL: https://agentalog.com
  • URL: https://agentalog.com/api/admin/listings/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

ID of the listing to moderate.

Request body

action'approve' | 'hide' | 'block' required

What to do with the listing.

reasonstring

Why, for whoever submitted: it comes back in GET /api/listings/:id/status. Required for block, optional for hide, ignored for approve (which clears an earlier reason). Up to 300 characters.

fixobject

Corrections applied together with approve, any of name, tagline, body, category, with the same validation as a submission. url and kind are refused: a new URL is what sends a listing back to the queue.

Response

{ ok, status, reason }

okboolean required

Always true.

statusstring required

The state the listing ended up in.

reasonstring required

The reason stored with the decision; empty when none.

Changes

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