diff --git a/deno/v8/gateway/mod.ts b/deno/v8/gateway/mod.ts
index 49480211..621b514b 100644
--- a/deno/v8/gateway/mod.ts
+++ b/deno/v8/gateway/mod.ts
@@ -32,7 +32,8 @@ export const enum GatewayOPCodes {
 	 */
 	Dispatch,
 	/**
-	 * Fired periodically by the client to keep the connection alive
+	 * A bidirectional opcode to maintain an active gateway connection.
+	 * Fired periodically by the client, or fired by the gateway to request an immediate heartbeat from the client.
 	 */
 	Heartbeat,
 	/**
diff --git a/v8/gateway/index.ts b/v8/gateway/index.ts
index 90b6cf37..4f8de86e 100644
--- a/v8/gateway/index.ts
+++ b/v8/gateway/index.ts
@@ -33,7 +33,8 @@ export const enum GatewayOPCodes {
 	 */
 	Dispatch,
 	/**
-	 * Fired periodically by the client to keep the connection alive
+	 * A bidirectional opcode to maintain an active gateway connection.
+	 * Fired periodically by the client, or fired by the gateway to request an immediate heartbeat from the client.
 	 */
 	Heartbeat,
 	/**