Skip to content

API Endpoint Template ​

Use this page as a starting point for every endpoint.

Summary ​

Describe what the endpoint does and who should use it.

Endpoint ​

http
POST /api/example

Authentication ​

State whether the endpoint requires auth and which scheme applies.

Request body ​

json
{
  "example": true
}

Response ​

json
{
  "success": true
}

Errors ​

  • 400 invalid request
  • 401 missing auth
  • 500 server error

Notes ​

  • Keep the summary short and specific.
  • Put the request example right after the summary.
  • Use bullets for errors so the page stays consistent with the rest of the docs.

Markdown-first documentation for teams that update docs often.