Skip to main content

Delete a Resource

The Delete method removes an entity from Deepser by sending an HTTP DELETE request with the entity ID in the URL path. On success, the API returns an empty response. On failure, the response contains error details.

Syntax

HTTP Method: DELETE

URL:

http://deepserhost/api/rest/[entity]/[id]

Example

The following request deletes the company with ID 6:

URL:

http://deepserhost/api/rest/company/6

Success response: Empty body with HTTP 200 status.

Error response (resource not found):


// this is only in case of an error
{
"messages": {
"error": [
{
"code": 404,
"message": "Resource not found."
}
]
}
}

warning

Deletion is permanent. Make sure you are targeting the correct entity ID before sending the request. Multiple Delete is not allowed for security reasons.