Chatsv2

Get chat background

GET/chats/{chatId}/background

Get the current background image metadata for a conversation. Works for both 1-on-1 and group chats.

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 details

401Authentication required or invalid

502Temporary communication error with 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 GET 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}