Launch

Generate single-use Mini App launch URL from operator backend.

Path

POST /api/operator/launch

Required scope: launch:write

Request body

{
  "external_user_id": "operator-user-123",
  "display_name": "Rina",
  "locale": "id",
  "host": "your-launch-host",
  "metadata": {}
}

Response

{
  "launch_url": "https://your-launch-host/launch?token=...",
  "expires_at": "2026-06-18T00:01:00.000Z",
  "operator_user": {
    "id": 1,
    "external_user_id": "operator-user-123",
    "status": "active"
  }
}

Contract rules

• Launch token is single-use.
• Default TTL is 60 seconds.
• external_user_id must be stable per operator user.
• Operator user is upserted on launch request.
• Launch host must match host configured for authenticated operator.
• Repeated launch calls may issue new launch tokens for same operator user.

Integration rules

• Call this endpoint only from operator backend.
• Redirect or hand off returned launch_url to operator client.
• Never generate or inspect launch token on client.