Revoke a license

Revoke (suspend) an existing license key for a project.

When a license is revoked:

• it becomes inactive

• any SDK/runtime calls using that license may be denied, depending on your enforcement flow

Endpoint

POST /project/{project}/licenses/{license}/revoke

Full URL:

https://api.devpayr.dev/api/v1/project/{project}/licenses/{license}/revoke

Authentication

✅ Required: API Key

Send your API key using:

X-API-KEY: <your_api_key>

Path Parameters

Parameter	Type	Required	Description
project	integer	Yes	The ID of the project that owns the license.
license	integer	Yes	The ID of the license record to revoke.

license here is the license ID, not the license key string (uuid).

Request Body

No request body is required.

Example Request

curl -X POST "https://api.devpayr.dev/api/v1/project/2/licenses/1/revoke" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

Response

Success (200)

Returns a standard success envelope with a confirmation message.

Example Response

{
  "status": "success",
  "message": "License revoked successfully.",
  "data": null,
  "errors": null
}

Access Rules

DevPayr validates the request in the following order:

1) API key must be allowed to manage the project

Project-scoped API keys

• If your API key is scoped to a project, it must match the {project} in the URL.

Error (403)

{ "message": "This API key is not allowed to revoke licenses for this project." }

Global API keys

• If your API key is global, it must belong to the owner of the project.

Error (403)

{ "message": "This API key does not have permission to manage this project." }

2) License must belong to the project

If the license ID does not belong to the specified project:

Error (403)

{ "message": "The license does not belong to this project." }

3) License must be active before revoking

You can only revoke an active license.

Error (403)

{ "message": "License Key has to be active first before you can revoke it." }

Errors

Missing API Key (401)

{ "message": "Missing required X-API-KEY header." }

Invalid / Expired API Key (403)

{ "message": "Invalid or expired API key." }

Not Found (404)

If the project or license record does not exist:

{ "message": "Resource not found." }

Rate Limited (429)

{ "message": "Too many requests. Please slow down." }