hosting

POST `/v1/sites/{siteId}/rename-domain`

Change a site's primary domain (asynchronous).

પ્રમાણીકરણ

એપીઆઈ કી (API key) ને બેરર ટોકન તરીકે મોકલો. કી પાસે sites.create પરવાનગી હોવી આવશ્યક છે; તેના વગરની કીને 404 ને બદલે 403 સાથે અસ્વીકાર કરવામાં આવશે.

આ એન્ડપૉઇન્ટ કોઈ સંસ્થા આઈડી (organisation id) લેતું નથી. તમારી કી (key) પહેલેથી જ તે જે સંસ્થા સાથે સંબંધિત છે તેની ઓળખ કરે છે, અને પ્રતિસાદ (response) તે જ પૂરતો મર્યાદિત છે.

આયમાવો

કોઈપણ કૌંસમાં રહેલી બાબતને તમારા પોતાના મૂલ્યોથી બદલો અને કી પ્લેસહોલ્ડરને તમારા ડેશબોર્ડની કીથી બદલો.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/rename-domain \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "new_domain": <Hostname> }'

साइन ઇન કરેલ છે? તમારા ડેશબોર્ડમાં આવેલું API કન્સોલ તમારી વાસ્તવિક સંસ્થાની આઈડી અને તમારી પોતાની કી ભરે છે, અને લાઇવ API સામે વિનંતી ચલાવે છે જેથી તમે વાસ્તવિક પ્રતિસાદ જોઈ શકો. આ અંતિમબિંદુને API કન્સોલમાં ખોલો

વિગતો

Starts the durable rename-domain saga for a site (new-side setup → flip → old-side teardown, register #91). Returns 202 Accepted immediately — the work runs as a Temporal workflow; poll the site or subscribe to site.* events for completion. Requires sites.create (the same authority that provisions a site). Idempotent on the site: a repeat call while the saga is running is accepted and does not start a second run.

પેરામીટર્સ

નામ	પ્રકાર	જરૂરી	તે શું છે
`siteId (path)`	`Uuid`	હા	Site ID (UUIDv7).

રિકવેસ્ટ બોડી

નામ	પ્રકાર	જરૂરી	તે શું છે
`new_domain`	`Hostname`	હા	The site's new primary domain (FQDN).
`keep_old_as_alias`	`boolean`	ના	Keep serving the old domain as an alias of the site after the flip.

જવાબ

નામ	પ્રકાર	જરૂરી	તે શું છે
`site_id`	`Uuid`	હા	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`new_domain`	`Hostname`	હા	A fully-qualified DNS hostname, lowercase, no trailing dot.
`workflow_id`	`string`	હા	The Temporal workflow id running the rename saga (deterministic per site).
`status`	`string<accepted>`	હા	The saga was accepted; poll the site / `site.*` events for completion.

આ એન્ડપોઇન્ટ જે ભૂલો પરત કરી શકે છે

401 · 403 · 404 · 409 · 422 · 429 · 503

POST /v1/sites/{siteId}/rename-domain