docs: improve the documentation of the endpoints 📝

[kareemmahlees]

No description provided.

[codecov]

Codecov Report

Attention: Patch coverage is 4.70297% with 385 lines in your changes missing coverage. Please review.

Project coverage is 13.47%. Comparing base (dfecb91) to head (14ca83a).
Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
internal/graph/generated.go	0.00%	381 Missing ⚠️
internal/graph/schema.resolvers.go	0.00%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #13      +/-   ##
==========================================
- Coverage   13.52%   13.47%   -0.06%     
==========================================
  Files          23       23              
  Lines        4783     4780       -3     
==========================================
- Hits          647      644       -3     
  Misses       4106     4106              
  Partials       30       30              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.