BetaThe V4 API is in beta — endpoints and functionality may change.
Groupsv4

Set group icon

POST/groups/{groupId}/icon

Uploads a group icon. Max 10MB; image/jpeg|png|gif|webp|heic|heif. Requires the group chat to be linked on a device.

Path parameters

groupIdRequiredstring

Unique identifier of the group, prefixed with grp_. Returned by the List groups endpoint.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

form-data
iconRequiredstring

Returns

dataoptionalobject
idoptionalstring
icon_urloptionalstring | null

Response codes

200Icon set
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
404No group was found with the provided `groupId`.
409The request conflicts with the current state of the group (e.g. it already exists, the chat is closed, or the channel isn't active).

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X POST https://api.blooio.com/v4/groups/grp_a1b2c3d4/icon \  -H "Authorization: Bearer bl_live_..." \  -F "file=@/path/to/file"
Response objectexample
{  "data": {    "id": "obj_a1b2c3d4",    "icon_url": "https://example.com"  }}