Expose image attachments on comments in the REST API

Hi Figma team,

Since images in comments launched, teams have used them heavily for visual references and bug reports. There's still no way for plugins or integrations to read or write those images.

What we found:

- GET /v1/files/:key/comments returns only the text of a comment that has an image. There's no attachment field, including with as_md.

- POST /v1/files/:key/comments accepts only message, comment_id and client_meta, so there's no way to attach an image.

- The REST API spec (figma/rest-api-spec), FILE_COMMENT webhooks and the Plugin API don't include comment attachments either.

- Comment images don't show up in GET /v1/files/:key/images.

Why it matters: anyone who moves, archives, exports or syncs comments (to Jira, Linear, Notion, or between files when a design is reorganised) loses every image. Users see comments arrive without the screenshots that gave them meaning.

What would help:

1. An attachments array on the Comment object, with { id, url, mime_type, width, height }. The URLs can be short-lived signed URLs, like image fills.

2. A way to attach images when creating a comment (an upload endpoint + attachment ids on POST).

3. Read-only support (1) alone would already unblock exports and backups.

We build Spool, a plugin for migrating comment threads between files, and this is our most requested missing piece. Happy to test an early version.

Thanks!