---
title: "Emit WebSocket event to connected clients"
method: POST
path: "/v1/websocket"
tags: ["websocket-admin"]
---

# Emit WebSocket event to connected clients

`POST /v1/websocket`

## Request

- Base URL: `https://lpad-backend.stage.defi.ovh.gala.com`
- URL: `https://lpad-backend.stage.defi.ovh.gala.com/v1/websocket`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/gala/apis/launchpad-backend-api/docs/v1/websocket/post.ts> (a function with typed inputs; its response is checked against the schema)

Send a real-time event to WebSocket subscribers (admin/overseer only)

## Request body

- object
  - `action` 'trade_executed' | 'balance_updated' | 'trade_update_notify' | 'stream_status' | 'viewer_count' | 'stream_countdown' | 'recording_status' | 'recordings_count_updated' | 'download_ready' | 'simulcast_status' | 'stream_language_updated' | 'chat_message' | 'chat_status' | 'typing_indicator' | 'stream_chat_sent' | 'stream_chat_updated' | 'stream_chat_deleted' | 'stream_chat_pinned' | 'stream_chat_unpinned' | 'stream_control_status_changed' | 'send_stream_reaction' | 'stream_reaction' | 'content_reaction_added' | 'content_reaction_removed' | 'comment_created' | 'comment_updated' | 'comment_deleted' | 'token_banned' | 'token_unbanned' | 'moderator_added' | 'moderator_removed' | 'moderator_invite_created' | 'moderator_role_updated' | 'overseer_added' | 'overseer_removed' | 'user_banned' | 'user_unbanned' | 'ban_enforcement' | 'user_profile_updated' | 'api_key_created' | 'api_key_updated' | 'api_key_revoked' | 'holder_count_updated' | 'pool_badge_assigned' | 'pool_created' | 'pool_metadata_updated' | 'pool_social_links_updated' | 'token_config_updated' | 'ai_moderation_complete' | 'ai_moderation_failed' | 'content_flagged' | 'flag_resolved' | 'site_config_changed' | 'feature_status' | 'chat_global_status' | 'streaming_global_status' | 'comments_global_status' | 'webhooks_global_status' | 'ai_moderation_global_status' | 'stats_updated' | 'event', required
  - `broadcast` boolean
  - `payload` object, required
  - `tokenName` string
  - `userAddress` string

## Response `200`

Event was emitted; the success envelope contains an empty data object.

- object
  - `error` false, required: Successful response marker.
  - `message` string, required: Response message.
  - `status` number, required: HTTP status code.
  - `data` [object Object], required

## Other responses

- `400`: Invalid event DTO or validation error
- `401`: Unauthorized - missing or invalid JWT/API key
- `403`: Forbidden - user is not admin or overseer
- `500`: Internal server error - failed to emit event
- `default`: Shared error envelope for event emission failures.

---

[API](https://skmtc.dev/gala/apis/launchpad-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/launchpad-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/launchpad-backend-api/revisions/74545971be2b?raw)