Delete a license

Delete a license key from a project.

Use this when you want to permanently remove a license record (for example: cleanup, fraud, duplicates, or an internal admin action).

Endpoint

DELETE /project/{project}/licenses/{license}

Full URL:

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

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 delete.

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

Request Body

No request body is required.

Example Request

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

Response

Success (200)

Returns a confirmation message plus a small result object.

Example Response

{
    "status": "success",
    "message": "License deleted successfully.",
    "data": {
        "id": 3,
        "status": "deleted"
    },
    "errors": null
}

Access Rules

DevPayr validates the request in this 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 {project}.

Error (403)

{ "message": "This API key is not allowed to delete 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) Ownership must match (project + license must belong to the API key owner)

If the license does not belong to the project, or the project/license does not belong to the API key’s owner, deletion is blocked.

Error (422)

{
  "message": "The given data was invalid.",
  "errors": {
    "error": [
      "You do not have permission to delete this license key."
    ]
  }
}

This error comes back as a validation-style response.

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." }