Delete
Endpoint DELETE /<plural-segment>/{id}
Where <plural-segment>
is the pluralized name of your domain class, e.g., for the class Sloth
, the endpoint would be DELETE /sloths/{id}
. The {id}
is the identifier of the element, typically of type Guid
.
Refer to the Endpoint segments section for information on changing the way the plural segment name is generated for your API types. By default, the pluralization follows standard English rules.
Response Codes
- 204 No Content: Indicates that the deletion was successful.
- 404 Not Found: Returns a
NotFoundResult
if the object is not found. - 400 Bad Request: Returns a
BadRequestResult
if the request is invalid.
Request Parameters
The Delete endpoint requires the id
parameter in the path, which is the identifier of the element. The type of id
is as specified in the entity configuration, defaulting to Guid
.
Example Domain Class:
public class Sloth : ISlothfulEntity
{
public Guid Id { get; private set; }
public string Name { get; private set; }
public int Age { get; private set; }
public string DisplayName => Name;
public Sloth(Guid id, string name, int age)
{
Id = id;
Name = name;
Age = age;
}
public void Update(string name, int age)
{
Name = name;
Age = age;
}
}
Generated Endpoint:
DELETE /sloths/{id}
Response Codes:
- 204
- 404
- 400
Request Parameters:
- Path:
id: guid