Skip to main content
DELETE
/
searches
/
{id}
Delete a search
curl --request DELETE \
  --url https://app.prontohq.com/api/v2/searches/{id} \
  --header 'X-API-KEY: <api-key>'
{
  "message": "Search deleted successfully"
}

​
Description

Deletes a specific search by its ID. This operation will permanently remove the search and all associated tasks from the system. Only the owner of the search can delete it.

​
Parameters

​
Path Parameters

  • id (required, string, UUID): The unique identifier of the search to delete

​
Responses

​
200 OK

The search was successfully deleted. 
{
  "message": "Search deleted successfully"
}

​
401 Unauthorized

You are not authorized to delete this search. This may be because you do not own the search, or the search owner is not part of your workspace. 
{
  "error": "Unauthorized"
}

​
404 Not Found

The search with the specified ID does not exist. 
{
  "error": "Search not found"
}

​
422 Unprocessable Entity

The search deletion failed for an unknown reason. 
{
  "error": "Failed to delete search"
}

​
Notes

  • When a search is deleted, all related tasks are also deleted automatically
  • This operation cannot be undone
  • Only searches owned by the authenticated user or within the user’s workspace can be deleted

Authorizations

​
X-API-KEY
string
header
required

Your API key

Path Parameters

​
id
string<uuid>
required

ID of the search to delete

Response

Search deleted successfully

​
message
string
Example:

"Search deleted successfully"