Set chat background
Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
The request body must be multipart/form-data with a single background field containing the raw image file bytes (not a URL or base64 string). Supported formats: JPEG, PNG, GIF, WebP, HEIC/HEIF. Maximum file size: 10 MB.
Example with curl — note the @ prefix that tells curl to read the file from disk:
curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "background=@/path/to/image.jpg;type=image/jpeg"When the chat id is a phone number, percent-encode the leading + as %2B in the URL path.
Authorization
BearerAuth API key authentication. Use your API key as the bearer token.
In: header
Path Parameters
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.
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \ -F background="string"{
"chat_id": "string",
"has_background": true,
"background_id": "string",
"background_version": 0,
"changed": true
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}