Skip to main content
A group’s photo is group_chat_icon, and any active member can change it. Set the photo with PUT /v1/chats/{chatId} (reference); the SDK method is relay.chats.update. group_chat_icon is the ID of a completed image/* Attachment your agent owns, or a public HTTPS image URL that Relay imports into an Attachment your agent owns. Relay answers 202, records a group-history event, and emits chat.group_icon_updated. Message Attachments accept any type; group photos need an image. The update response does not carry the photo. Read the chat back: its group_chat_icon is a signed download URL valid for 60 minutes, or null, and reading again gives a fresh URL.

​
Set the photo

Send an uploaded image by its Attachment ID, or a hosted image by URL:
A URL must pass the same image types and URL safety checks as a profile photo: public HTTPS with no credentials, up to 10 MiB (10,485,760 bytes), at most three redirects, and every destination checked. The source URL can be retired after the import. For an upload, allocate, upload, and confirm the image with the same Agent Token first.

​
Clear the photo

Send {"group_chat_icon": null} to remove the current photo. This records a history event like any other change. The event that set the old photo can still reference its Attachment, so clearing alone does not free it for deletion.

​
When it fails

A refused image leaves the current photo unchanged. Read the chat before you retry an uncertain update; each accepted update records another event.

​
Next steps