# vespa document remove

[](/en/reference/clients/vespa-cli/vespa_document_remove.html.md "View as Markdown") 

## vespa document remove

Removes a document from Vespa

### Synopsis

Removes the document specified either as a document id or given in the json file. If the document id is specified both as an argument and in the file the argument takes precedence.

```
vespa document remove id | json-file [flags]
```

### Examples

```
$ vespa document remove src/test/resources/A-Head-Full-of-Dreams-Remove.json
$ vespa document remove id:mynamespace:music::a-head-full-of-dreams
```

### Options

```
-d, --data string Document data to use instead of reading from file or stdin
      --header strings Add a header to the HTTP request, on the format 'Header: Value'. This can be specified multiple times
  -h, --help help for remove
  -T, --timeout int Timeout for the document request in seconds (default 60)
  -v, --verbose Print the equivalent curl command for the document operation
  -w, --wait int Number of seconds to wait for service(s) to become ready. 0 to disable (default 0)
```

### Options inherited from parent commands

```
-a, --application string The application to use. Format "tenant.application.instance" - instance is optional (tenant required for cloud targets)
  -C, --cluster string The container cluster to use. This is only required for applications with multiple clusters
  -c, --color string Whether to use colors in output. Must be "auto", "never", or "always" (default "auto")
  -i, --instance string The instance of the application to use
  -q, --quiet Print only errors
  -t, --target string The target platform to use. Must be "local", "cloud", "hosted" or an URL (default "local")
  -z, --zone string The zone to use. This defaults to a dev zone (cloud only)
```

### SEE ALSO

- [vespa document](vespa_document.html) - Issue a single document operation to Vespa

 Copyright © 2026 - [Cookie Preferences](#)

### On this page:

- [vespa document remove](#page-title)
- [vespa document remove](#vespa-document-remove)
- [Synopsis](#synopsis)
- [Examples](#examples)
- [Options](#options)
- [Options inherited from parent commands](#options-inherited-from-parent-commands)
- [SEE ALSO](#see-also)