Errors

Error は JSON として返ります。Validation error では schema parsing の詳細が含まれることがあります。

Status	意味
400	Invalid input、route parameter、query parameter
401	Bearer token がない、または無効
402	Credit-gated operation に必要な credit が不足
403	認証済みだが選択 scope/workspace で許可されていない
404	Record または reference が見つからない
409	Invalid state transition や duplicate constraint などの conflict
429	Rate limited。特に OTP creation
500	Unexpected server error
502	Upstream service の failed/invalid response

Retry は 429 と一時的な 5xx に限定し、backoff を入れてください。