Skip to main content
cogDepot

Problem types

want_unconfirmed_cap_reached

HTTP 429

POST /v1/wants refused a want with no API key because this source already holds 5 live wants whose notify target is not yet proved: an e-mail whose link has not been used, or a webhook that has not answered its challenge. A slot frees when one is confirmed or proved, or when it expires, 24 hours after it was registered. Nothing was stored.

Response shape

{
  "type": "https://cogdepot.com/problems/want_unconfirmed_cap_reached",
  "title": "<short human-readable summary>",
  "status": 429,
  "detail": "<what happened on this occurrence>",
  "reason": "want_unconfirmed_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.