diff --git a/doc/README.md b/doc/README.md
index 890ac85e7f2..0c52de0f8b5 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -19,6 +19,7 @@ APIs:
   * [Contents](repo/contents.md)
   * [Releases](repo/releases.md)
     * [Assets](repo/assets.md)
+  * [Tags](repo/tags.md)
   * [Deployments](repo/deployments.md)
 * [Users](users.md)
 * [Meta](meta.md)
diff --git a/doc/repo/tags.md b/doc/repo/tags.md
new file mode 100644
index 00000000000..95e35bb0665
--- /dev/null
+++ b/doc/repo/tags.md
@@ -0,0 +1,8 @@
+## Repo / Tags API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../README.md)
+
+### List all tags
+
+```php
+$tags = $client->api('repo')->tags('twbs', 'bootstrap');
+```