## defradb client document delete

Delete documents by docID or filter.

### Synopsis

Delete documents by docID or filter and list the number of documents deleted.

This is a soft delete. The document's data and commit history remain available locally
and can be accessed using the --show-deleted flag on the 'document get' command
or the showDeleted parameter on GraphQL queries.

```
defradb client document delete [flags]
```

### Examples

```
delete by docID:  
  defradb client document delete --collection-name User --docID bae-123

delete by docID with identity:  
  defradb client document delete --collection-name User --docID bae-123 \
  	-i 028d53f37a19afb9a0dbc5b4be30c65731479ee8cfa0c9bc8f8bf198cc3c075f

delete by filter:  
  defradb client document delete --collection-name User --filter '{ "_geq": { "points": 100 } }'
```

### Options

```
      --collection-id string     Collection ID
      --collection-name string   Collection name
      --docID string             Document ID
      --enable-signing           Override signing for this operation
      --filter string            Document filter
      --get-inactive             Get inactive collections as well as active
  -h, --help                     help for delete
      --version-id string        Collection version ID
```

### Options inherited from parent commands

```
      --audience string             Audience to set on minted auth tokens. Defaults to the host of --url
  -i, --identity string             Hex formatted private key used to authenticate with ACP
      --log-format string           Log format to use. Options are text or json (default "text")
      --log-level string            Log level to use. Options are debug, info, error, fatal (default "info")
      --log-output string           Log output path. Options are stderr or stdout. (default "stderr")
      --log-overrides string        Logger config overrides. Format <name>,<key>=<val>,...;<name>,...
      --log-source                  Include source location in logs
      --log-stacktrace              Include stacktrace in error and fatal logs
      --no-log-color                Disable colored log output
      --rootdir string              Directory for persistent data (default: $HOME/.defradb)
      --source-hub-address string   The SourceHub address authorized by the client to make SourceHub transactions on behalf of the actor
      --tx uint                     Transaction ID
      --url string                  URL of HTTP endpoint to listen on or connect to (default "127.0.0.1:9181")
```

### SEE ALSO

* [defradb client document](defradb_client_document.md)	 - Interact with documents.