Change an iMessage chat background

Experimental. Set an iMessage conversation's background to a photo or gradient, or clear it. Needs a line that supports backdrops, comms_send, and an Idempotency-Key. The recipient needs iOS 26 or another Apple OS that shows backgrounds, and a 202 doesn't mean they see it. Images can be JPEG, PNG, or WebP (not animated), up to 3 MiB, 24 megapixels, and 8192 pixels per side. They're cropped to a 1080×2340 portrait frame, and metadata is removed. To retry, send the exact same request with the same idempotency key.

post/conversations/{conversation_id}/backdrop

Request

  • Base URL: https://osis.co/api/v1/comms
  • URL: https://osis.co/api/v1/comms/conversations/{conversation_id}/backdrop
  • Auth: HTTP bearer

Path parameters

conversation_idstring required

Headers

Idempotency-Keystring required

Request body

OR
OR

Response

Background change accepted. Comms can't confirm what the recipient sees.

conversation_idstring required
status'submitted' | 'unknown' | 'processing' required
operation_idstring nullable required
replayedboolean required
recipient_appliedunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.