Back to Eliza

Domain Buy Failure Modes

packages/skills/skills/eliza-cloud-buy-domain/references/failure-modes.md

2.0.1923 B
Original Source

Domain Buy Failure Modes

StatusMeaningCorrect response
400Invalid domain formatAsk for a normal hostname like myapp.com.
402Not enough Cloud creditsTell the user to top up in billing before buying.
404App missing or wrong organizationRe-check appId; do not charge or retry blindly.
409Domain unavailable or attached elsewhereSuggest alternatives from /domains/search.
502Cloudflare registration failedThe API refunds the debit; report the error and retry only if the user wants.

Never auto-buy a paid domain. The user must explicitly confirm the exact domain after seeing the price.

If the same user asks to retry the same domain after a partial success, call the same /domains/buy route once. It can recover local metadata for a domain that Cloudflare already registered and returns alreadyRegistered instead of charging again.