Show personas an image or a PDF

Until this release, every persona response was based on words alone. You could describe a logo to a persona, but you couldn't show them one. The new attachment endpoints close that gap.

What's new

• `POST /v1/media-assets` uploads an image or a PDF and returns a media_asset_id. Allowed types: PNG, JPEG, WebP, PDF. Maximum file size: 10 MB. Filenames are sanitised on upload.

• All question endpoints accept attachments. Pass an attachments array on POST /v1/research-studies/{id}/questions, POST /v1/research-agents/{agent_id}/questions, or POST /v1/research-groups/{group_id}/questions. Each entry references a media_asset_id you've already uploaded.

• The personas actually see the file. Image attachments are passed to the model as image inputs; PDF attachments are passed as file inputs. The persona's response reflects the contents — not just the filename.

• Up to eight attachments per question, capped at 10 MB each. Total per turn is bounded by the underlying model's input limits.

Use cases

• Concept testing. Upload three packaging variants and ask twelve personas which one signals "premium". Get the actual reactions, not abstracted descriptions.

• Sales-collateral feedback. Show a one-pager to a hand-picked B2B persona; ask whether the value proposition lands.

• Logo / brand-identity screening. Show a logo across a recruited group; gather first-impressions.

• Document review. Attach a draft press release as PDF; ask a target audience how it reads.

The MCP tool catalogue includes media-asset upload, so the in-product agent and the Slack agent can drive the full flow — upload the image, run the question, return the responses — in one conversation.

Full reference is in the API docs.

---