diff --git a/docs/reference/docs/delete.asciidoc b/docs/reference/docs/delete.asciidoc index f7677886ef3..a130e66a191 100644 --- a/docs/reference/docs/delete.asciidoc +++ b/docs/reference/docs/delete.asciidoc @@ -57,10 +57,9 @@ The above will delete a tweet with id 1, but will be routed based on the user. Note, issuing a delete without the correct routing, will cause the document to not be deleted. -Many times, the routing value is not known when deleting a document. For -those cases, when specifying the `_routing` mapping as `required`, and -no routing value is specified, the delete will be broadcast -automatically to all shards. +When the `_routing` mapping is set as `required` and no routing value is +specified, the delete api will throw a `RoutingMissingException` and reject +the request. [float] [[delete-parent]] @@ -75,6 +74,10 @@ to use the <> to perform a index with the automatically generated (and indexed) field _parent, which is in the format parent_type#parent_id. +When deleting a child document its parent id must be specified, otherwise +the delete request will be rejected and a `RoutingMissingException` will be +thrown instead. + [float] [[delete-index-creation]] === Automatic index creation