Docs
Groupsv2

Remove group icon

DELETE/groups/{groupId}/icon

Remove the group icon/photo. Requires the group to have an iMessage conversation.

The icon is removed from both Blooio storage and the group's iMessage conversation before the request returns.

Path parameters

groupIdRequiredstring

Unique identifier of the group chat, prefixed with grp_ (e.g. grp_abc123def456). Returned by the create-group and list-groups endpoints.

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

Returns

successoptionalboolean
group_idoptionalstring
chat_guidoptionalstring

Deprecated. An identifier for the group's iMessage conversation, kept for existing integrations. Use group_id to identify the group.

icon_urloptionalstring

URL of the uploaded icon (only present on set)

device_syncoptionalobject

Linked chat sync status

chat_guidoptionalstring

Deprecated. The same value as the top-level chat_guid.

syncedoptionalboolean

Whether the icon change was synced to the linked iMessage chat. This will be true on successful set/remove operations.

messageoptionalstring

Status message about linked chat sync

messageoptionalstring

Response codes

200Group icon removed successfully
400Invalid request parameters
401Authentication required or invalid
404Resource not found
502Failed to update the linked iMessage chat
503No active number available

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

Request
curl -X DELETE https://api.blooio.com/v2/api/groups/grp_abc123def456/icon \
Response objectexample
{  "success": false,  "group_id": "grp_a1b2c3d4",  "chat_guid": "obj_a1b2c3d4",  "icon_url": "https://example.com",  "device_sync": {    "chat_guid": "obj_a1b2c3d4",    "synced": false,    "message": "Hello from Blooio!"  },  "message": "Hello from Blooio!"}