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 or reissue a permit pass

PATCH
/passes/{id}
[N-05] Revoke and [Q-04] Reissue a permit's QR pass. Select the operation with action:
{ "action": "revoke", "reason"?: "…" } — sets the permit to REVOKED and immediately invalidates its QR access code. Audit trail records the actor, reason, and timestamp.
{ "action": "reissuePass" } — permit must be ACCEPTED. The current QR/access code is invalidated immediately (old code rejected at the gate from that point), a new code is minted, fresh permit documentation is regenerated, and a passes.permits.issued event fires with the new QR payload.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

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

🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request PATCH '/passes/' \
--header 'Content-Type: application/json' \
--data '{
    "action": "revoke",
    "reason": "Permit cancelled by DAMAC."
}'
Response Response Example
200 - Example 1
{}
Previous
Update permit — dates / NOC
Next
passes.permits.issued
Built with