Delete a project

Permanently delete (soft-delete) an existing project using an API key.

Deleting a project removes access to all associated resources, including:

• project domains

• licenses

• injectables

This action is irreversible from the API. Deleted projects cannot be restored.

Endpoint

DELETE /project/{project}

Full URL:

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

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

Authorization Rules

Before deleting a project, DevPayr enforces multiple authorization checks.

1. Ownership

• The project must belong to the API key’s user.

• Attempting to delete another user’s project is not allowed.

2. API Key Scope

• Global API keys may delete any project owned by the user.

• Project-scoped API keys may only delete their own scoped project.

If a scoped key attempts to delete a different project, the request is rejected.

3. Subscription Plan Permission

Your subscription plan must explicitly allow project deletion.

If your plan does not permit deleting projects via API, the request is rejected.

Error (403)

{ "message": "You are not authorized to delete this project via API." }

Example Request

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

Response

Success (200)

If the project is successfully deleted, DevPayr returns a confirmation response.

Example Response

{
  "status": "success",
  "message": "Project deleted successfully.",
  "data": null,
  "errors": null
}

The project is soft-deleted and immediately becomes inaccessible via the API.

Deletion Behavior

• The project is soft-deleted.

• All future API requests referencing the deleted project will fail.

Errors

Missing API Key (401)

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

Invalid / Expired API Key (403)

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

Unauthorized Deletion (403)

Returned when:

• the project does not belong to the API key owner

• the API key is scoped to another project

• the subscription plan does not allow deletion

{ "message": "You are not authorized to delete this project via API." }

Project Not Found (404)

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

Rate Limited (429)

{ "message": "Rate limit exceeded (X requests/min). Please slow down." }

Best Practices & Warnings

• Double-check project IDs before deletion.

• Avoid calling this endpoint from client-side environments.

• Use this endpoint only from trusted backend services.

• Consider disabling deletion in production workflows unless absolutely necessary.