diff --git a/doc/api/errors.md b/doc/api/errors.md
index f7fb1a28b12d41..e4a709d45a8031 100644
--- a/doc/api/errors.md
+++ b/doc/api/errors.md
@@ -956,6 +956,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 354877dba08781..ba7b5b9e6c14d6 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -1251,6 +1251,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]])