---
title: "App Lifecycle events"
method: POST
path: "/app-lifecycle"
tags: ["Standard"]
---

# App Lifecycle events

`POST /app-lifecycle`

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.

## Headers

- `TR_ID` string
- `x-lc-signature` string

## Request body

- AppLifecycleEvent — Lifecycle event data for the app. The 'data' payload can vary depending on the id of the lifecycle event. For `REGISTERED` event there is the `RegisteredEvent` data that contains the `clientCredentials`. This is in contrast to v1.3 of the descriptor, where the credentials were sent received on install.
  - `id` 'REGISTERED' | 'UNREGISTERED' | 'INSTALLLED' | 'UNINSTALLED' | 'UPDATED', required — Identifies the type of lifecycle event. Could be extended in the future with more events.
  - `timestamp` string, date-time, required — Timestamp of when the event happened in ISO-8601 format with timezone in UTC.
  - `data` union — The data related to the specific event. Can be null if there is no extra data.
    - RegisteredEvent
      - `clientCredentials` object, required
        - `clientId` string, required
        - `clientSecret` string, required
    - UpdatedEvent
      - `clientCredentials` object
        - `clientId` string, required
        - `clientSecret` string, required
    - InstalledEvent
      - `region` string — Tenant region.

## Response `200`

## Other responses

- `400` — Unexpected message structure or data.
- `401` — Signature validation failed.

## Changes

- **2026-01-27** (v1) `9d9d8922a0ce` — 2 info
  - the endpoint scheme security `LanguageCloudJWSToken` was removed from the API
  - added the new optional `header` request parameter `x-lc-signature`
- **2025-11-18** (v1) `ce288dbb23be` — 1 info
  - added `#/components/schemas/InstalledEvent` to the `data` request property `oneOf` list

[Change history](https://skmtc.dev/rws/apis/app-api/changes/app-lifecycle/post.md)

---

[API](https://skmtc.dev/rws/apis/app-api.md) · [All operations](https://skmtc.dev/rws/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rws/app-api/revisions/a06e1ee1c99b/schema)