Put an image in the post
place_imageRead-onlyIdempotent
Requires a TechFabric engineer's Microsoft sign-in (scope blog.write). A read: the Markdown for an image already uploaded to your draft, , and with markdown the post with it in after the paragraph after names (or at the end) and the image rules read on it. Alt text is required (WCAG 2.1): without it, or with one that is the file name, "screenshot", the caption again, under 5 or over 250 characters, it returns the question to ask the engineer and no snippet: never write one yourself. decorative: true, only on the engineer's word, places a decorative image with empty alt. Saves nothing: save the post with update_draft.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The draft's 8-character id (list_drafts lists yours) | |
| alt | No | The engineer's own description of what it shows, 5 to 250 characters, not the file name, "screenshot" or the caption (WCAG 2.1); never yours. Refused, with the reason, when it doesn't serve | |
| name | Yes | The image's name, as the upload answered | |
| after | No | A few words of the paragraph the image goes after; left out, it goes at the end | |
| caption | No | A caption shown under it (optional, at most 140 characters) | |
| markdown | No | The whole post: returned with the image in, and the image rules read on it | |
| decorative | No | true only when the engineer says the image is purely decorative: no alt, no caption, and screen readers skip it |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| next | Yes | ||
| problem | No | Why the alt text was refused: empty, short, long, filename, generic or caption | |
| snippet | Yes | ||
| findings | Yes | ||
| markdown | No | ||
| question | No | ||
| needs_alt | Yes | ||
| next_action | No |