Revoke a pass

POST /passes/{id}/revoke

Requires the passes:revoke permission.

Warning

Important: This action is permanent and irreversible. Voided passes cannot be reactivated using the reinstate endpoint.

Authorization

X-API-Key required

Parameters

Name	Location	Type	Required
id	path	string	Yes

Request Examples

curl -X POST "https://api.remypass.com/api/v1/public/passes/507f1f77bcf86cd799439011/revoke" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

Use Case Examples

Revoke a pass permanently

Sets pass status to void. Voided passes cannot be reinstated; issue a new pass if needed.

curl -X POST https://api.remypass.com/api/v1/public/passes/507f1f77bcf86cd799439013/revoke \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Responses

Status	Description
200	Successful operation.
400	Bad request or validation error.
401	Missing or invalid API key.
403	The caller is not allowed to access this resource.
404	Resource not found.
500	Server error.

200 Response Example

{
  "success": true,
  "message": "string",
  "data": {}
}

Response Fields

Field	Type	Attributes
success	boolean
message	string
data	object