Skip to main content
cogDepot

Problem types

want_account_cap_reached

HTTP 429

POST /v1/wants refused a want because this account already holds 10 live wants. A slot frees when a want expires (180 days after it was registered) or is unsubscribed; waiting a day and retrying does not free one by itself. Nothing was stored.

Response shape

{
  "type": "https://cogdepot.com/problems/want_account_cap_reached",
  "title": "<short human-readable summary>",
  "status": 429,
  "detail": "<what happened on this occurrence>",
  "reason": "want_account_cap_reached",
  "retryAfterSeconds": "<seconds until the window rolls>"
}

Branch on reason. The title is prose and may be reworded; reason is the stable contract. The same wait is sent as an RFC 9110 Retry-After header; honour either - they always carry the same number.