@@ -62,17 +62,23 @@ A resource that supports soft delete **should** provide an `Undelete` method:
6262
6363### Create
6464
65- If a user attempts a create on a soft-deleted resource, the request **must**
66- succeed, acting as if the resource did not exist previously.
65+ Create methods **must** adhere to one of the following:
66+
67+ - If a user attempts a create on a soft-deleted resource, the create **must**
68+ succeed, acting as if the resource did not exist previously.
69+ - The create must accept a field (query parameter for OAS),
70+ `overwrite_soft_deleted`. If set to `false`, the request **must** fail if a
71+ soft-deleted resource exists. If set to `true`, the request **must** succeed
72+ if the resource exists acting as if the resource did not exist previously.
6773
6874### List and Get
6975
7076Soft-deleted resources **must not** be returned in `List` AEP-132 responses by
7177default (unless `bool show_deleted` is true).
7278
7379A `Get` AEP-131 request for a soft deleted resource **must** return with a
74- `410 Gone ` response unless `bool show_deleted` is true, in which case
75- soft-deleted resources **must** return the resource.
80+ `404 Not Found ` response unless `bool show_deleted` is true, in which case
81+ soft-deleted resources **must** return the resource (with the `DELETED` state value if the resource includes a [`state` field](/states)) .
7682
7783Services that soft delete resources **may** choose a reasonable strategy for
7884purging those resources, including automatic purging after a reasonable time
0 commit comments