Groupsv4

Update a group

PATCH/groups/{groupId}

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

JSON

nameRequiredstring

Returns

dataoptionalGroup

idoptionalstring

Group id (grp_...).

channel_idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

nameoptionalstring | null

icon_urloptionalstring | null

chat_idoptionalstring | null

chat_linkedoptionalboolean

Whether the group is linked to a device chat.

created_atoptionalinteger

membersoptionalGroupMember[]

Array of GroupMember

identity_idoptionalstring

contact_idoptionalstring | null

roleoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

identifieroptionalstring

Response codes

200Updated group

401Your API key is missing or invalid. Pass it as a bearer token.

404No group was found with the provided `groupId`.

422Validation failed — one or more fields in the request are invalid or missing.

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

Request

curl -X PATCH https://api.blooio.com/v4/groups/grp_a1b2c3d4 \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "name": "Jane Doe"  }'

Body object

{  "name": "Jane Doe"}

Response objectexample

{  "data": {    "id": "grp_a1b2c3d4",    "channel_id": "ch_a1b2c3d4",    "channel_type": "blooio",    "name": "Jane Doe",    "icon_url": "https://example.com",    "chat_id": "chat_a1b2c3d4",    "chat_linked": false,    "created_at": 0,    "members": [      {        "identity_id": "idn_a1b2c3d4",        "contact_id": "ct_a1b2c3d4",        "role": "string",        "channel_type": "blooio",        "identifier": "+15551234567"      }    ]  }}