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

Get chat background

GET/chats/{chatId}/background

Reads the chat's background image (Blooio channels). Reads live from the device.

Path parameters

chatIdRequiredstring

Unique identifier of the chat, prefixed with chat_. Returned by the List chats 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

Returns

dataoptionalobject
chat_idoptionalstring
has_backgroundoptionalboolean
background_idoptionalstring | null
background_versionoptionalinteger | null
background_urloptionalstring | null

Response codes

200Background info
401Your API key is missing or invalid. Pass it as a bearer token.
404No chat was found with the provided `chatId`.

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/v4/chats/chat_a1b2c3d4/background \  -H "Authorization: Bearer bl_live_..."
Response objectexample
{  "data": {    "chat_id": "chat_a1b2c3d4",    "has_background": true,    "background_id": "obj_a1b2c3d4",    "background_version": 0,    "background_url": "https://example.com"  }}