access

DELETE /v1/sites/{siteId}/collaborators/{grantId}

Revoke one person's access to this site.

Semua titik akhir access

Autentikasi

Kirimkan kunci API sebagai token bearer. Titik akhir ini tidak menyatakan izin tertentu dalam spesifikasi, jadi berikan kunci Anda izin minimum yang diperlukan dan periksa responsnya alih-alih berasumsi.

Endpoint ini tidak memerlukan id organisasi. Kunci Anda telah mengidentifikasi organisasi tempatnya berafiliasi, dan respons akan dibatasi untuk organisasi tersebut.

Coba

Ganti apa pun di dalam tanda kurung sudut dengan nilai Anda sendiri, dan placeholder kunci dengan kunci dari dasbor Anda.

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

Sudah masuk? Konsol API di dasbor Anda akan mengisi ID organisasi asli dan kunci Anda sendiri, serta menjalankan permintaan terhadap API langsung sehingga Anda dapat melihat respons aktualnya. Buka titik akhir ini di konsol API

Detail

Ends the grant. The row is kept and marked revoked rather than deleted, so the audit question survives. When it was that person's last live grant in this organisation their `site_collaborator` membership is removed too — left behind it is a dormant unrestricted membership waiting for somebody to add a second role to it. Idempotent: revoking an already-revoked grant answers `204`, not `404` or `409`. A client retrying after a dropped response must not be told it failed.

Parameter

NamaJenisWajibTentang apa ini
siteId (path)UuidYaSite ID (UUIDv7).
grantId (path)stringYaThe grant to revoke.

Kesalahan yang dapat dikembalikan oleh titik akhir ini

401 · 403 · 404 · 429