Chatsv2

Remove chat background

DELETE/chats/{chatId}/background

Remove the background image from a conversation, reverting to the default appearance.

Path parameters

chatIdRequiredstring

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

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

chat_idoptionalstring

Normalized chat identifier (phone number, email, or group ID)

has_backgroundoptionalboolean

Whether the chat currently has a background set

background_idoptionalstring | null

Unique identifier for the current background, or null if none

background_urloptionalstring | null

Public URL of the persisted background image stored in R2. Returned after a successful PUT and on GET when a background has been set through the API. May be null if persistence failed or the background was set outside of the API.

background_versionoptionalinteger | null

Version number of the background (for cache invalidation)

changedoptionalboolean

Whether the background was changed by this operation (only present on PUT)

Response codes

200Chat background removed successfully

401Authentication required or invalid

502Failed to remove background on device

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/chats/chat_a1b2c3d4/background \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "chat_id": "chat_a1b2c3d4",  "has_background": true,  "background_id": "obj_a1b2c3d4",  "background_url": "https://example.com",  "background_version": 0,  "changed": false}