devices

Revoke Device

Revoke a device credential immediately — the kill switch for a lost, stolen, or decommissioned device (RFID portal, barcode gun, PLC, camera, robot, tool, sensor). Its next evidence post is refused. Idempotent: revoking an already-revoked device reports already_revoked and mints no second receipt. Requires the device:admin permission (owner-only, needs full, never reachable through OAuth).

post/devices/{id}/revoke

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/devices/{id}/revoke
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

device_idstring required

Device ID to revoke

reasonstring

Why this device is being revoked (up to 500 characters)

Response

Success. JSON body: { data: ... } or an error object { error, message }.

Changes

No recorded changes to this operation across all 1 revision of this API.