# delete

Delete one or more pod(s)

```
Usage: pi delete pods POD [OPTIONS]

Delete a pod

          -e, --access-key                API access key
          -k, --secret-key                API secret key
          -r, --region                    Region name, default: gcp-us-central1
          -u, --user                      Username
          --all                           Delete all resources, including uninitialized ones, in the namespace of the specified resource types.
          --force                         Immediate deletion of some resources may result in inconsistency or data loss and requires confirmation.
          --grace-period                  Period of time in seconds given to the resource to terminate gracefully. Ignored if negative.
          --now                           If true, resources are signaled for immediate shutdown (same as --grace-period=1).
```

```bash
$ pi delete pods busybox
pod "busybox" deleted
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperhq.gitbook.io/pi-docs/reference/cli/pod/delete.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.