Skip to content

Commit ca8fec1

Browse files
committed
address review feedback
1 parent 9e8d12f commit ca8fec1

2 files changed

Lines changed: 21 additions & 19 deletions

File tree

aep/general/0164/aep.md.j2

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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

7076
Soft-deleted resources **must not** be returned in `List` AEP-132 responses by
7177
default (unless `bool show_deleted` is true).
7278

7379
A `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

7783
Services that soft delete resources **may** choose a reasonable strategy for
7884
purging those resources, including automatic purging after a reasonable time

package-lock.json

Lines changed: 11 additions & 15 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)