Documentation
  1. API
  • Visitor Management API
    • Getting Started
      • Overview
    • API Reference
      • Logs
        • Get filtered Events logs
      • Accesses
        • Create new QR Access
      • Users
        • Create new Property Manager
        • Update existing Property Manager
    • External Visits
      • External NFC Visit
  • Visitor Management Webhooks
    • Getting started with webhooks
    • Security & Signature Verification
  • Work Permit DAMAC integration
    • API
      • Create contractor
        POST
      • Revoke contractor
        PATCH
      • Create NOC / fit-out permit
        POST
      • Get permit (reconciliation)
        GET
      • Update permit — dates / NOC
        PATCH
      • Revoke or reissue a permit pass
        PATCH
    • Webhooks
      • passes.permits.issued
      • passes.permits.updated
      • passes.permits.expiring
      • passes.permits.expired
      • passes.permits.scanned
      • passes.permits.firstScanned
      • passes.permits.lastScanned
      • communityContractors.approved
      • communityContractors.removed
  1. API

Revoke contractor

PATCH
/communityContractors/{id}
[C-05] Remove a contractor from the DAMAC community.
Body: { "action": "revoke" }.
Removal detaches the contractor from the community, archives all of their active permits (each archived permit emits a passes.permits.updated event, invalidating its QR access code), and emits a communityContractors.removed event.
The same endpoint also accepts { "action": "approve" }, though approval is normally performed by a Community Admin from the dashboard.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Contractor updated.
Bodyapplication/json

🟠401Unauthorized
🟠404Record Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/communityContractors/' \
--header 'Content-Type: application/json' \
--data '{
    "action": "revoke"
}'
Response Response Example
200 - Example 1
{}
Previous
Create contractor
Next
Create NOC / fit-out permit
Built with