Document rate limits clearly

http

RateLimit-Limit: 100
RateLimit-Remaining: 24
RateLimit-Reset: 60

Explanation

Returning limit metadata helps clients self-throttle and debug rate-limit behavior.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Same sheet · prioritizing Best practices

Use the same top-level response structure across endpoints.

Open In sheettextsame section

Make support and debugging easier.

Open In sheethttpsame section

Prefer explicit timezone-aware datetime strings.

Open In sheettextsame section

Show real requests and responses in docs.

Open In sheetbashsame section

Avoid route names that duplicate the HTTP method.

Open In sheettext1 tag match

Use HTTP status codes meaningfully.

Open In sheettext1 tag match