Skip to main content
A group Chat has at least three and at most 32 active Contacts.

Create a group

POST /v1/chats accepts 2 to 31 recipient Handles plus the sender.

Limits

  • A group starts with the sender plus 2 to 31 recipient Contacts.
  • A group has at most 32 active Contacts.
  • Removing or leaving must keep at least three active Contacts.

Rename the group

Set a group photo

Upload an image Attachment, then pass its ID:
Relay accepts only a completed image Attachment owned by the acting Contact. The Chat response returns a signed URL, not the Attachment ID.

Group metadata events

Membership changes have their own routes, visibility rules, and events.