Skip to main content

listing_image

2 operation(s). All run through POST /syteops/v1/manage/dispatch (reads may use the documented GET form).

reprocess​

Rebuild the listing-card image for each image the article owns, from scratch, even when one looks current: the failure memo is cleared and the repair is re-queued (paid). The live crop stays until the new one replaces it, so this is not destructive. At most 25 images per call; same refusals, 10-minute per-article cooldown and site-wide daily image allowance as run.

Access: SyteOps Admin or API key.

Parameters

ParameterTypeRequiredDescription
post_idintegeryesRecord id, digits only.

Returns

data: {post_id, processed, queued, failed, skipped, items[] is {attachment_id, built, queued, error?, repaired?, reason?, retrying?}}

Request

{
"resource": "listing_image",
"action": "reprocess",
"params": {
"post_id": 0
}
}

run​

Build the listing-card image for each image the article owns that lacks a current one (the same unforced path a page render takes; images already current are left alone). With the repair on this queues paid jobs. At most 25 images per call. 409 listing_image_disabled when the feature is off; 429 cooldown (10 minutes per article, shared with reprocess, released when nothing was built or queued); 429 daily_limit when the site-wide daily allowance of images (100 by default, counted per image across run and reprocess, refunded when nothing was built or queued) is used up; processed and queued count only images built or newly queued, and changed is true only then; 404 post_not_found for a missing, trashed or non-viewable post.

Access: SyteOps Admin or API key.

Parameters

ParameterTypeRequiredDescription
post_idintegeryesRecord id, digits only.

Returns

data: {post_id, processed, queued, failed, skipped, items[] is {attachment_id, built, queued, error?, repaired?, reason?, retrying?}}

Request

{
"resource": "listing_image",
"action": "run",
"params": {
"post_id": 0
}
}