v10

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-242047102.4 KB
Standard

App Lifecycle events

Endpoint to receive lifecycle events for the registered app. (Including registration event).

Note: The INSTALLED event must be idempotent, meaning that it should return OK even if the account is already successfully installed.

post/app-lifecycle

Headers

TR_IDstring

A trace id, to help track problems. If it's not received, an auto-generated value will be used for logging. TR_ID header should also be set on the response.

x-lc-signaturestring

JWS token containing the signature and additional claims.

Request body

id'REGISTERED' | 'UNREGISTERED' | 'INSTALLLED' | 'UNINSTALLED' | 'UPDATED' required

Identifies the type of lifecycle event. Could be extended in the future with more events.

timestampstring date-time required

Timestamp of when the event happened in ISO-8601 format with timezone in UTC.