Delete test

DELETE

/test/{id}

const url = 'https://testomato.com/api/test/5e9602e7a39e5a46428b457f';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://testomato.com/api/test/5e9602e7a39e5a46428b457f \
  --header 'Authorization: Bearer <token>'

Permanently delete a check.

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique test ID

Example

5e9602e7a39e5a46428b457f

Responses

200

Check was successfully deleted

application/json

object

message

string

default: Check was successfully deleted

success

boolean

default: true

error

boolean

Example

{
  "message": "Check was successfully deleted",
  "success": true,
  "error": false
}

401

The API token is missing, malformed or expired. Request a new one from POST /api/authenticate.

application/json

object

message

Error message text

string

default: Access denied! Please log in to access this resource.

code

Error code number

integer

default: 401

boolean

error

boolean

default: true

Example

{
  "message": "Access denied! Please log in to access this resource.",
  "code": 401,
  "ok": false,
  "error": true
}

403

The token is valid but the operation is not allowed. Two distinct causes:

the subscription plan does not include API access — every endpoint returns this, regardless of the resource
the account lacks the required role on the project — reading needs read, changing checks needs editTests, and so on. See Project permissions.

application/json

object

message

Error message text

string

default: Sorry! Your current plan does not support access to Testomato API.

code

Error code number

integer

default: 403

boolean

error

boolean

default: true

Example

{
  "message": "Sorry! Your current plan does not support access to Testomato API.",
  "code": 403,
  "ok": false,
  "error": true
}

404

Object not found error

application/json

object

message

Error message text

string

default: Object not found

code

Error code number

integer

default: 404

boolean

error

boolean

default: true

Example

{
  "message": "Object not found",
  "code": 404,
  "ok": false,
  "error": true
}