diff --git a/doc/api/errors.md b/doc/api/errors.md
index 13193f95ca9af8..8632bb7be28484 100755
--- a/doc/api/errors.md
+++ b/doc/api/errors.md
@@ -775,6 +775,12 @@ required to send an acknowledgment that it has received and applied the new
be sent at any given time. This error code is used when that limit has been
reached.
+
+### ERR_HTTP2_NESTED_PUSH
+
+An attempt was made to initiate a new push stream from within a push stream.
+Nested push streams are not permitted.
+
### ERR_HTTP2_NO_SOCKET_MANIPULATION
diff --git a/doc/api/http2.md b/doc/api/http2.md
index 3da544420077dc..cd4edbc6c89214 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -1261,6 +1261,9 @@ Setting the weight of a push stream is not allowed in the `HEADERS` frame. Pass
a `weight` value to `http2stream.priority` with the `silent` option set to
`true` to enable server-side bandwidth balancing between concurrent streams.
+Calling `http2stream.pushStream()` from within a pushed stream is not permitted
+and will throw an error.
+
#### http2stream.respond([headers[, options]])