diff --git a/docs/docs/docs/specs/files.md b/docs/docs/docs/specs/files.md
index 4d62e33d5..0775f779d 100644
--- a/docs/docs/docs/specs/files.md
+++ b/docs/docs/docs/specs/files.md
@@ -31,6 +31,20 @@ Files can be used by `threads`, `assistants` and `fine-tuning`
 ```
 
 ## File API
+### List Files
+> OpenAI Equivalent: https://platform.openai.com/docs/api-reference/files/list
+
+### Upload file
+> OpenAI Equivalent: https://platform.openai.com/docs/api-reference/files/create
+
+### Delete file
+> OpenAI Equivalent: https://platform.openai.com/docs/api-reference/files/delete
+
+### Retrieve file
+> OpenAI Equivalent: https://platform.openai.com/docs/api-reference/files/retrieve
+
+### Retrieve file content
+> OpenAI Equivalent: https://platform.openai.com/docs/api-reference/files/retrieve-contents
 
 ## Files Filesystem
 
@@ -45,5 +59,4 @@ Files can be used by `threads`, `assistants` and `fine-tuning`
 /threads
     /jan-12938912
         /files          # thread-specific files
-
 ```