DELETE/api/v1/licensing/keys/{id}

Revoke License Key

Deactivate a license key, revoking access for the associated self-hosted instance. The instance will fall back to the Community (free) plan on its next validation cycle. Only the organization owner can revoke keys.

Request

Headers

HeaderRequiredDescription
AuthorizationYesBearer token

Path Parameters

ParameterTypeRequiredDescription
idstringYesUUID of the license key to revoke

Example Request

curl -X DELETE https://app.storno.ro/api/v1/licensing/keys/019c8a12-4567-7abc-def0-123456789abc \
  -H "Authorization: Bearer {token}"

Response

Success Response (200 OK)

{
  "status": "revoked"
}

Error Codes

CodeDescription
401Unauthorized — Missing or invalid token
403Forbidden — User is not the organization owner
404Not Found — License key not found or belongs to a different organization

Usage Notes

  • Revocation is soft delete — the key record is kept but marked as active: false
  • Since JWT licenses are validated offline, a revoked key continues to work until it expires. Generate a new key with a shorter expiration if immediate revocation is needed.
  • Revoked keys cannot be reactivated. Generate a new key instead.