Delete Alert By Id
9 min
endpoint information url {gateway url}/alerts/{id}/plan/{planid} method delete authentication required ( bearer token ) company header required ( x company id ) headers header type required description authorization string yes bearer token used for authentication example bearer \<your access token> x company id long yes the company id used to scope the request accept string no recommended value application/json path parameters parameter type required description id long yes the unique id of the alert to delete must be a positive number planid long yes the unique id of the test plan that owns the alert must be a positive number request body this endpoint does not require a request body response body if the delete operation is completed successfully, the endpoint returns http 200 ok with an empty json object {} response fields this endpoint does not return response fields the response does not include data , result code , or result message behavior notes the service first checks whether the given planid exists and is accessible then it deletes the alert record matching both id and planid if the plan exists but there is no alert matching the given id and planid , the current implementation still completes successfully and returns {} error response format error responses use the common problem detail format { "instance" "/alerts/999/plan/999999", "status" 404, "title" "not found", "type" "https //errors testinium com/exception", "timestamp" "2026 08 18t12 08 41 165927056z", "errortype" "exception", "errors" { "code" 10003, "message" "plan with id 999999 not found!" } } error codes http code error message description 400 bad request the request is malformed, contains invalid path parameters, or a required header is missing 401 unauthorized authentication failed, authentication is required, or the token is invalid 403 forbidden the user does not have permission to access the requested resource or company 404 not found the related test plan could not be found 500 internal server error an unexpected error occurred on the server side application error codes code error type http code description 10000 exception 401 authentication failed 10001 exception 401 authentication is required to access this resource 10002 exception 401 the provided token is invalid 10003 exception 403 / 404 the user is not authorized for the resource, or the requested test plan could not be found 10004 exception 400 a required header is missing for example, x company id is not provided 10007 exception 403 the user does not have access to the requested resource 20005 validation 400 the id or planid path parameter is invalid for example, it is not a positive number 20008 validation 400 the id or planid path parameter has an invalid type example request curl location request delete '{gateway url}/alerts/{id}/plan/{planid}' \\ \ header 'accept application/json' \\ \ header 'authorization bearer \<your access token>' \\ \ header 'x company id \<company id>'