hosting

DELETE `/v1/sites/{siteId}/transfer`

Withdraw this site's pending transfer offer.

توثيقِ شناخت

ایک بیرر ٹوکن کے طور پر ایک API کی بھیجیں۔ کی کے پاس sites.view اجازت ہونی چاہیے؛ اس کے بغیر کی کو 404 کے بجائے 403 کے ساتھ مسترد کر دیا جاتا ہے۔

یہ اینڈ پوائنٹ کوئی آرگنائزیشن آئی ڈی نہیں لیتا۔ آپ کی کلید پہلے ہی اس آرگنائزیشن کی شناخت کرتی ہے جس سے یہ تعلق رکھتی ہے، اور اس کا جواب اسی کے مطابق محدود ہوتا ہے۔

آزمائیں

کوئی بھی چیز جو زاویہ دار قوسین میں ہو اسے اپنی اقدار سے بدلیں، اور کلیدی پلیس ہولڈر کو اپنے ڈیش بورڈ کی کسی کلید سے بدلیں۔

curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/transfer \
  -H "Authorization: Bearer zdk_live_…"

لاگ ان ہیں؟ آپ کے ڈیش بورڈ میں موجود API کنسول آپ کی حقیقی تنظیم کی آئی ڈی اور آپ کی اپنی کلید خود بخود پُر کر دیتا ہے، اور لائیو API پر درخواست چلاتا ہے تاکہ آپ اصل ردعمل دیکھ سکیں۔ اس اینڈ پوائنٹ کو API کنسول میں کھولیں

تفصیلات

The sender takes the offer back. Takes no body and returns the offer, which will read `cancelled`. ⛔ **`DELETE` on the *offer*, not `POST …/cancel`** — the resource being removed is the pending offer, and giving the undo its own noun means no request body can turn a withdrawal into something else by being slightly wrong. `404` when there is no pending offer. Requires `sites.view` **and** `sites.transfer`.

پیرامیٹرز

نام	قسم	لازمی	یہ کیا ہے
`siteId (path)`	`Uuid`	ہاں	Site ID (UUIDv7).

جواب

نام	قسم	لازمی	یہ کیا ہے
`id`	`Uuid`	ہاں	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_id`	`Uuid`	ہاں	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_name`	`string`	نہیں	The site's name as it was when the offer was made. Snapshotted onto the offer, not read live: while a transfer is pending the site still belongs to the sender, and reading it li…
`primary_domain`	`string`	نہیں	The site's domain as it was when the offer was made. Snapshotted, as above.
`direction`	`string<incoming, outgoing>`	ہاں	From this caller's point of view. Computed per request, never stored — the same row is outgoing to one party and incoming to the other.
`status`	`string<pending, accepted, declined, cancelled, expired, failed>`	ہاں	Five terminal states rather than one, because why an offer ended is what support is actually asked. `failed` means it was accepted and could not complete; nothing moved.
`include_domain`	`boolean`	ہاں	Whether the domain, its DNS and its mail travel with the site.
`recipient_email`	`string`	نہیں	Only populated for the sender. To the receiver it is their own address and carries no information; to anyone else it would be a third party's email address in a row two orga…
`message`	`string`	نہیں	—
`expires_at`	`string`	ہاں	An unaccepted offer expires fourteen days after it is made.
`term_ends_at`	`string`	نہیں	—
`renewal_amount_minor`	`integer`	نہیں	—
`renewal_currency`	`string`	نہیں	—
`created_at`	`string`	ہاں	—
`decided_at`	`string`	نہیں	—
`failure_reason`	`string`	نہیں	Why a `failed` transfer could not complete. Empty otherwise.

وہ خرابیان جو یہ اینڈ پوائنٹ واپس کر سکتا ہے

401 · 403 · 404 · 409 · 429

DELETE /v1/sites/{siteId}/transfer