# Api rate limit message survey

Improve rate-limit guidance.

If nothing was unclear or difficult, say so. Skip questions about steps you did not experience; use not applicable where appropriate.

## 1. What did the limit message explain?

Answer: ____________________

## 2. Which retry instruction was unclear?

Answer: ____________________

## 3. What usage information was missing?

Answer: ____________________

## Author notes / illustrative keys where applicable

1. Look for message meaning.
2. Look for retry clarity.
3. Look for usage context.

Interpretation caution: Do not invent quotas or guaranteed reset times.


## Illustrative finding and follow-up

Observation: Errors omit the relevant limiting scope.

Action to test: Explain documented limit scope and retry guidance.

Follow-up: After the proposed change, ask relevant participants whether this original issue still occurs: Errors omit the relevant limiting scope. Record what they experienced, including none or not applicable; changes in the sample do not establish causation.