Replace burned domains
Starts one job that swaps every replaceable burned domain.
Send exactly one replacement_domains entry per burned domain
(alphabetically paired), or send [] to learn the required count
from a domain_count_mismatch error. One job runs at a time.
Poll GET /domains/burned/replace/{id}, then page
.../results for every row. Each swap also emits swap.created.
POST
Only Peeker-bought domains can be replaced. Send
replacement_domains: [] first if you do not know the count. The
domain_count_mismatch error lists every burned domain and how many
replacements you need.Authorizations
Partner API key (pk_live_… or pk_test_…).
Body
application/json
One new domain per replaceable burned domain. Send an empty array to discover the required count via the domain_count_mismatch error.
Response
Replacement job accepted; poll it for progress.
Last modified on August 25, 2026