Sign in
Retention Messages V2

Retrieve Retention Message

Retrieves a retention message by ID. Requires retention_messages:read scope.

get/v2/retention-messages/{id}

Path parameters

idstring required

Retention message ID

Retention message ID

Response

Success

idstring required

Unique identifier

object'retention_message' required

Object type, always retention_message

application_idstring required

Application ID

message_group_idinteger nullable required

an integer

namestring required

Display name of the retention message

environment'sandbox' | 'production' required

Apple environment this message belongs to

localestring required

BCP-47 locale code (e.g. en-US)

apple_message_identifierstring required

Current Apple message identifier

apple_message_state'PENDING' | 'APPROVED' | 'REJECTED' | 'UNKNOWN' required

Raw Apple review state for this message identifier

apple_upload_state'not_uploaded' | 'uploading' | 'uploaded' | 'failed' required

Superwall-to-Apple upload state

apple_upload_attempt_countnumber required
apple_upload_last_errorstring nullable required
apple_uploaded_atstring nullable required
headerstring required

Message header text

bodystring required

Message body text

alt_textstring nullable required

Image alt text, or null

image_identifierstring nullable required

Apple image identifier (pre-uploaded), or null

created_atstring required

ISO 8601 timestamp

updated_atstring required

ISO 8601 timestamp

Changes

No recorded changes to this endpoint across all 2 revisions of this API.