Gala Launchpad API reference

OpenAPI 3.0.3; 172 operations across 136 paths.

Servers

https://lpad-backend.stage.defi.ovh.gala.com
https://lpad-backend-prod1.defi.gala.com

Authentication schemes

apiKeyAuth: apiKey, header x-api-key
bearer: http (bearer), JWT
muxSignature: apiKey, header mux-signature

Error envelope

400 Analysis already exists or in progress / Bad request - action parameter invalid (must be DELETE_CONTENT, BAN_USER, or BOTH) / Bad request - address parameter invalid format / Bad request - address parameter invalid format, or skip/limit parameters invalid / Bad request - address parameter not a valid wallet address format / Bad request - confirm=true required / Bad request - content is missing, empty, or exceeds max length (500 for chat, 2000 for comment) / Bad request - contentType invalid, contentId missing, or required reason missing for stream type / Bad request - either tokenName or userAddress must be provided, invalid txnType, invalid dates, or skip/limit invalid / Bad request - either tokenName or userAddress must be provided, skip/limit parameters invalid, invalid sort field, or invalid type filter / Bad request - expiresAt is not a valid ISO 8601 timestamp or is in the past / Bad request - fullName exceeds max length (255 chars) or profileImage URL is invalid / Bad request - invalid address / Bad request - invalid address format or user is already an overseer / Bad request - invalid preference values / Bad request - invalid query parameters or tokenName format / Bad request - invalid token name / Bad request - invalid token or platform / Bad request - inviteCode is missing, invalid format, not found, already claimed, revoked, or expired / Bad request - inviteScope is invalid (TOKEN or ALL_OWNER_TOKENS), or role not valid / Bad request - neither role nor description provided, or role is invalid / Bad request - platform is invalid, URL is malformed or missing, or streamKey is missing / Bad request - reactionType is invalid emoji format or messageId is not a valid UUID / Bad request - role is invalid (MODERATOR/TECHNICAL_PRODUCER/MANAGER/OWNER), expiresAt not valid ISO 8601, or token names invalid / Bad request - role is invalid (must be MODERATOR, MANAGER, or TECHNICAL_PRODUCER) / Bad request - role is invalid, expiresAt not valid ISO 8601, or token names not found / Bad request - skip/limit parameters invalid / Bad request - stream already active, Mux connection failed, or test mode query parameter is invalid / Bad request - token not found / Bad request - tokenName missing or invalid, or skip/limit parameters invalid / Bad request - tokenName missing or reason exceeds max length / Bad request - tokenName missing, content missing/empty/exceeds max length, invalid message type, or other validation error / Bad request - tokenName query parameter is missing / Bad request - userAddress invalid format or reason exceeds max length / Bad request - userAddress query parameter missing or invalid format / Bad request - webhook payload is invalid / Bad request - webhook payload is invalid or malformed / Bundle validation or intake error. / Chat status could not be updated. / Invalid amount parameter / Invalid configuration / Invalid event DTO or validation error / Invalid file format or size / Invalid input / Invalid parameters / Invalid query parameters / Invalid route or bad request. / Invalid slowModeSeconds value / Invalid token configuration / Invalid token name. / Invalid user address / Missing or invalid tokenName parameter / Platform configuration could not be retrieved.: ApiErrorEnvelope, ApiErrorResponseDto, BundleErrorResponseDto, ConnectErrorResponseDto
401 Missing or invalid session. / Unauthorized / Unauthorized - invalid or missing Mux webhook signature / Unauthorized - missing or invalid JWT or API key / Unauthorized - missing or invalid JWT token / Unauthorized - missing or invalid JWT token in Authorization header / Unauthorized - missing or invalid JWT token or API key / Unauthorized - missing or invalid JWT token or admin API key / Unauthorized - missing or invalid JWT/API key / Unauthorized - missing or invalid admin API key / Unauthorized - missing or invalid authentication / Unauthorized - signature verification failed or address invalid / Unauthorized - token invalid, expired, or missing / Unauthorized - valid authentication required: ApiErrorEnvelope, ApiErrorResponseDto, ConnectErrorResponseDto
403 Forbidden / Forbidden - admin or overseer role required / Forbidden - insufficient permissions / Forbidden - only token owner can delete recordings / Forbidden - only token owner can download recordings / Forbidden - requires MANAGE_COMMUNITY permission / Forbidden - token owner only / Forbidden - user is banned and cannot update profile / Forbidden - user is not a system admin or overseer / Forbidden - user is not a system admin or overseer, or attempting to revoke their own access / Forbidden - user is not admin or overseer / Forbidden - user is not message author or moderator with MANAGE_CHAT permission, or user is banned / Forbidden - user is not the API key owner / Forbidden - user is not the invite creator or user is banned / Forbidden - user is not the message author or user is banned / Forbidden - user is not token owner or user is banned / Forbidden - user lacks MANAGE_SIMULCAST permission / Forbidden - user lacks MANAGE_SIMULCAST permission or user is banned / Forbidden - user lacks MANAGE_STREAM_SETTINGS permission / Forbidden - user lacks RESET_STREAM_KEY permission or user is banned / Forbidden - user lacks START_STREAM permission or no active stream / Forbidden - user lacks START_STREAM permission, global streaming is disabled, user is banned, or profile incomplete / Forbidden - user lacks STOP_STREAM permission or user is banned / Forbidden - user lacks permission to action this flag / Forbidden - user lacks permission to dismiss this flag / Forbidden - user lacks permission to view flags / Forbidden - user profile incomplete / Forbidden - user profile incomplete or user is banned / Forbidden - user profile incomplete, user is banned, or messaging disabled: ApiErrorEnvelope, ApiErrorResponseDto
404 API key not found - id parameter does not match any existing key / Analysis not found / Ban not found - user has no global ban / Flag not found / Flag not found - id parameter does not match any existing flag / Invite code not found or expired - code parameter does not match any valid invite / Invite not found - code parameter does not match any existing invite / Invite not found - id parameter does not match any existing invite / Message not found - id parameter does not match any existing message / Message not found - messageId does not exist / Not found - profile does not exist. / Not found - token does not exist. / Overseer not found - address parameter does not match any existing overseer / Reaction not found - messageId/reactionType combination does not exist for this user / Recording not found / Recording not found - assetId does not match any recording for this token / Recording not found or does not belong to this token / Token not found / Token not found - tokenName does not match any existing pool / Token not found - tokenName does not match any existing pool or ban not found / Token not found - tokenName does not match any existing pool when scope is TOKEN / Token not found - tokenName does not match any pool / Token not found - tokenName query parameter invalid or token does not exist / Token not found or no image available / Token not found or no stream configured / Token not found or no vault address / Token not found or simulcast targetId does not exist for this token / Token not found or stream not currently active / Token not found. / Token or ban not found / Transaction with the requested id was not found. / User not found - address parameter does not match any existing user: ApiErrorEnvelope, ApiErrorResponseDto, BundleErrorResponseDto, OEmbedErrorResponseDto
500 Available roles could not be retrieved. / Bundle intake failed. / Bundle status lookup failed. / Chat status could not be retrieved. / Chat status could not be updated. / Client feature flags could not be retrieved. / Configuration could not be updated. / Internal server error - Mux API failure or database error while creating stream / Internal server error - Mux API failure or database error while resetting stream key / Internal server error - Mux API failure or database error while stopping stream / Internal server error - ban stats query failed / Internal server error - blockchain query failed or service unavailable / Internal server error - cache flush failed / Internal server error - database query failed / Internal server error - failed to aggregate managed tokens from database / Internal server error - failed to aggregate user data from database / Internal server error - failed to aggregate user stats from database / Internal server error - failed to calculate platform metrics from database / Internal server error - failed to create API key in database / Internal server error - failed to create ban in database / Internal server error - failed to create flag in database / Internal server error - failed to create invite in database / Internal server error - failed to create overseer in database / Internal server error - failed to create simulcast target in database / Internal server error - failed to delete message from database or broadcast via WebSocket / Internal server error - failed to delete reaction from database / Internal server error - failed to delete recording from Mux / Internal server error - failed to delete simulcast target from database / Internal server error - failed to emit event / Internal server error - failed to execute action in database / Internal server error - failed to generate invite code or database error / Internal server error - failed to generate oEmbed data. / Internal server error - failed to list clients / Internal server error - failed to pin message in database or broadcast via WebSocket / Internal server error - failed to prepare download / Internal server error - failed to process webhook / Internal server error - failed to promote user to moderator in database / Internal server error - failed to promote user to overseer in database / Internal server error - failed to remove ban from database / Internal server error - failed to retrieve API key from database / Internal server error - failed to retrieve API keys from database / Internal server error - failed to retrieve holder data from blockchain or cache / Internal server error - failed to retrieve invite from database / Internal server error - failed to retrieve moderated tokens from database / Internal server error - failed to retrieve overseer status from database / Internal server error - failed to retrieve profile from database / Internal server error - failed to retrieve recordings from Mux / Internal server error - failed to retrieve simulcast configuration / Internal server error - failed to retrieve stream credentials / Internal server error - failed to retrieve tokens from blockchain or database / Internal server error - failed to revoke API key in database / Internal server error - failed to revoke invite in database / Internal server error - failed to save message to database or broadcast via WebSocket / Internal server error - failed to save reaction to database / Internal server error - failed to unpin message in database or broadcast via WebSocket / Internal server error - failed to update API key in database / Internal server error - failed to update flag in database / Internal server error - failed to update invite in database / Internal server error - failed to update invite status in database / Internal server error - failed to update message in database or broadcast via WebSocket / Internal server error - failed to update overseer status in database / Internal server error - failed to update profile in database / Internal server error - flag stats query failed / Internal server error - invite stats query failed / Internal server error - token ban stats query failed / Internal server error - user stats query failed / Internal server error while reading permission metadata. / Internal server error. / Platform configuration could not be retrieved. / Platform stats could not be retrieved. / Slow mode could not be updated.: ApiErrorEnvelope, ApiErrorResponseDto, BundleErrorResponseDto, ConnectErrorResponseDto, OEmbedErrorResponseDto
503 A critical dependency (database or Redis) is down. / GalaChain unavailable / Health check failed. / Service unavailable - database or Redis connection failed, dependencies unreachable: ApiErrorEnvelope
default Gala Connect request failed; the error envelope is returned. / Gala Connect response passed through; status and JSON payload vary by upstream route. / Shared authentication and service error envelope. / Shared error envelope for GALA balance lookup failures. / Shared error envelope for active user lookup failures. / Shared error envelope for authentication and download preparation failures. / Shared error envelope for authentication and invite claim failures. / Shared error envelope for authentication and overseer status lookup failures. / Shared error envelope for authentication and query failures. / Shared error envelope for authentication and recording deletion failures. / Shared error envelope for authentication and service failures. / Shared error envelope for authentication, authorization, and message deletion failures. / Shared error envelope for authentication, authorization, and pinning failures. / Shared error envelope for authentication, authorization, and service failures. / Shared error envelope for authentication, authorization, and unpinning failures. / Shared error envelope for authentication, authorization, validation, and service failures. / Shared error envelope for authentication, ownership, and service failures. / Shared error envelope for authentication, ownership, validation, and service failures. / Shared error envelope for authentication, profile, and service failures. / Shared error envelope for authentication, validation, and message service failures. / Shared error envelope for authentication, validation, and message update failures. / Shared error envelope for authentication, validation, and service failures. / Shared error envelope for authorization and ban stats failures. / Shared error envelope for authorization and flag stats failures. / Shared error envelope for authorization and invite creation failures. / Shared error envelope for authorization and invite query failures. / Shared error envelope for authorization and invite revocation failures. / Shared error envelope for authorization and invite stats failures. / Shared error envelope for authorization and overseer creation failures. / Shared error envelope for authorization and overseer list failures. / Shared error envelope for authorization and platform summary failures. / Shared error envelope for authorization and revocation failures. / Shared error envelope for authorization and token ban failures. / Shared error envelope for authorization and token ban listing failures. / Shared error envelope for authorization and token ban lookup failures. / Shared error envelope for authorization and token ban stats failures. / Shared error envelope for authorization and token unban failures. / Shared error envelope for authorization and user stats failures. / Shared error envelope for available permissions lookup failures. / Shared error envelope for connected-client lookup failures. / Shared error envelope for credential lookup failures. / Shared error envelope for current profile lookup failures. / Shared error envelope for dashboard authentication and query failures. / Shared error envelope for event emission failures. / Shared error envelope for fee lookup failures. / Shared error envelope for global ban creation failures. / Shared error envelope for global ban listing failures. / Shared error envelope for global ban lookup failures. / Shared error envelope for global unban failures. / Shared error envelope for image upload failures. / Shared error envelope for invalid event batches or processing failures. / Shared error envelope for invite lookup failures. / Shared error envelope for leaderboard failures. / Shared error envelope for managed-token lookup failures. / Shared error envelope for platform statistics failures. / Shared error envelope for pre-mint quote failures. / Shared error envelope for profile image upload failures. / Shared error envelope for profile update failures. / Shared error envelope for public profile lookup failures. / Shared error envelope for query validation and database failures. / Shared error envelope for quote calculation failures. / Shared error envelope for sale detail lookup failures. / Shared error envelope for simulcast lookup failures. / Shared error envelope for simulcast target creation failures. / Shared error envelope for simulcast target removal failures. / Shared error envelope for stream control failures. / Shared error envelope for stream key reset failures. / Shared error envelope for stream start failures. / Shared error envelope for stream stop failures. / Shared error envelope for token ban creation failures. / Shared error envelope for token ban listing failures. / Shared error envelope for token ban lookup failures. / Shared error envelope for token configuration failures. / Shared error envelope for token creation failures. / Shared error envelope for token list failures. / Shared error envelope for token lookup and holder service failures. / Shared error envelope for token lookup and pinned message failures. / Shared error envelope for token lookup and recording service failures. / Shared error envelope for token lookup failures. / Shared error envelope for token role failures. / Shared error envelope for token statistics failures. / Shared error envelope for token trade history failures. / Shared error envelope for token unban failures. / Shared error envelope for token validation failures. / Shared error envelope for trade query failures. / Shared error envelope for user listing failures. / Shared error envelope for user summary lookup failures. / Shared error envelope for user token listing failures. / Shared error envelope for weekly history failures. / Shared error envelope returned by the application exception filter.: ApiErrorEnvelope