English

简体中文

日本語

English (UK)

Deutsch

Français

Español

Italiano

हिन्दी

한국어

Português

Русский

العربية

English (CA)

English (AU)

Español (MX)
Log in
Get Started Free

Developer API

Code Plagiarism
Detection API

Build plagiarism detection into your apps. Check code against 20+ billion sources.

Documentation Get API Key

const response = await fetch('https://codequiry.com/api/v1/check', { method: 'POST', headers: { 'apikey': 'YOUR_API_KEY' }, body: formData }); // Check created!

DELETE CHECK API

Delete a Plagiarism Check

Permanently delete a plagiarism check and all associated submissions and results. This action cannot be undone.

API Endpoint

DELETE https://codequiry.com/api/v1/checks/{checkId}

POST https://codequiry.com/api/v1/check/delete

Two equivalent forms: Use the RESTful path form (DELETE /checks/{checkId}) with the check ID in the URL, or the POST form (POST /check/delete) with check_id in the request body. Both call the same handler.

Destructive Action: Deleting a check permanently removes all submissions, results, and analysis data. This cannot be reversed.

Authentication

Include your API key in the request header:

apikey: YOUR_API_KEY_HERE

Request Parameters

Parameter	Type	Required	Description
`checkId` (path) / `check_id` (body)	Integer	Required	The unique identifier of the check to delete. Provide it as the `{checkId}` URL segment (REST form) or as `check_id` in the body (POST form). Must belong to your account.

Success Response

HTTP Status: 200 OK

{
    "success": true,
    "message": "Check deleted successfully",
    "check_id": 2810,
    "check_name": "Python Assignment - Week 5"
}
        
            
                JSON Response

Response Fields

success — Boolean indicating the deletion was successful
message — Confirmation message
check_id — The ID of the deleted check
check_name — The name of the deleted check for confirmation

Error Responses

401 Unauthorized

Invalid or missing API key.

403 Forbidden

Returned for free-trial accounts ("Not able to delete during your trial. Upgrade to do this action.") or when attempting to delete a demo assignment ("Demo assignments cannot be deleted.").

404 Not Found

The specified check does not exist or does not belong to your account.

422 Unprocessable Entity

No check ID supplied ("check_id is required"), or no API Checks folder exists on your account ("No API Checks folder exists.").

409 Conflict

The check is currently being processed (status 6 or 7). Wait for analysis to complete before deleting.

Code Examples

cURL (REST path form)

curl -X DELETE "https://codequiry.com/api/v1/checks/2810" \
  -H "apikey: YOUR_API_KEY_HERE"
        
            cURL - REST

cURL (POST body form)

curl -X POST "https://codequiry.com/api/v1/check/delete" \
  -H "apikey: YOUR_API_KEY_HERE" \
  -d "check_id=2810"
        
            cURL - POST

JavaScript

async function deleteCheck(checkId) {
    const response = await fetch('https://codequiry.com/api/v1/check/delete', {
        method: 'POST',
        headers: {
            'apikey': 'YOUR_API_KEY_HERE',
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({ check_id: checkId })
    });

    const data = await response.json();

    if (data.success) {
        console.log(`Deleted check: ${data.check_name} (ID: ${data.check_id})`);
    } else {
        console.error(`Failed to delete: ${data.error}`);
    }
}

await deleteCheck(2810);
        
            JavaScript

Best Practices

Confirm Before Deleting: Always confirm with the user before deleting a check. Consider implementing a "soft delete" in your application by archiving results before calling this endpoint.

Wait for Completion: Do not attempt to delete a check while it is being processed (status 6 or 7). Wait for analysis to complete or fail before deleting.