diff --git a/docs/api-designs/deceased.md b/docs/api-designs/deceased.md new file mode 100644 index 000000000..bd34e99cd --- /dev/null +++ b/docs/api-designs/deceased.md @@ -0,0 +1,18 @@ +# Deceased API + +## `PUT` `/persons/deceased/` + +Where `` is the person's TRN. + +Request body structure: +```json +{ + "dateOfDeath": "" +} +``` + +The `dateOfDeath` property is mandatory and should be formatted `yyyy-MM-dd`. + +If no record exists with the specified TRN, a `404 Not Found` status code will be returned. + +If the request is valid, a `204 No Content` status code will be returned.