diff --git a/doc/api/packages/pypi.md b/doc/api/packages/pypi.md
index 1ef7f664d74c06e6a68035c6c29a2ade6cc47abe..960f34f45f1a94d620ec29baec727958ce2441e2 100644
--- a/doc/api/packages/pypi.md
+++ b/doc/api/packages/pypi.md
@@ -280,8 +280,17 @@ POST projects/:id/packages/pypi
 ```shell
 curl --request POST \
      --form 'content=@path/to/my.pypi.package-0.0.1.tar.gz' \
-     --form 'name=my.pypi.package' \
+     --form 'name=<your_pypi_package>' \
      --form 'version=1.3.7' \
+     --form 'sha256_digest=<sha_256_checksum>' \
      --user <username>:<personal_access_token> \
      "https://gitlab.example.com/api/v4/projects/1/packages/pypi"
 ```
+
+{{< alert type="note" >}}
+
+If you do not include the [`sha256_digest`](https://docs.pypi.org/api/upload/) form
+parameter in the request,
+subsequent downloads of the file fail.
+
+{{< /alert >}}