images:read
The images:read scope lets you browse a site’s Media Library and read everything Hrizn knows about an image: its public URL, alt text, AI-written title / caption / description, tags, dimensions, the prompt that generated it, the E-E-A-T disclaimer, the content item it is attached to, and every social-platform cut derived from it. It is included in the Full Access, Read Only, and Content Generation presets and in every MCP profile.
Reads are not plan-gated. Placeholder rows for in-flight or failed AI generations are hidden from the list unless you ask for them by status.
Endpoints
List images
ai, upload, oem, reference, social_variant). Filter with source, status, article_id, tag, or query. List rows omit variants — fetch a single image for those.
Example
Get image
variants[]. When the image is still generating, status is generating and image_url is null; the completed / failed transition is also delivered via the image.generation.* webhooks.
Using the response
- Put
alt_texton the<img>— for AI images it is rewritten by Hrizn’s alt-text pass shortly after generation. - Show
generation.disclaimernear any AI-generated vehicle image. - Pick a
variants[]entry bypreset_keywhen posting to a specific social platform instead of re-croppingimage_urlyourself.
Related
images:write— start or regenerate AI images.- Webhooks —
image.generation.completedandimage.generation.failed.