From 28dfdda49eadc52e12952d2751bb2f3dc4b5291d Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 24 Jul 2026 17:43:36 +0000
Subject: [PATCH] docs: document porter target create and delete commands

---
 .../cli/command-reference/porter-target.mdx   | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/standard/cli/command-reference/porter-target.mdx b/standard/cli/command-reference/porter-target.mdx
index b3cfc08f..3a72e0f9 100644
--- a/standard/cli/command-reference/porter-target.mdx
+++ b/standard/cli/command-reference/porter-target.mdx
@@ -44,6 +44,65 @@ Deployment targets allow you to deploy the same application to different environ
 
 ---
 
+## `porter target create`
+
+Create a new deployment target in the current cluster.
+
+**Usage:**
+```bash
+porter target create --name [name]
+```
+
+**Options:**
+
+| Flag | Description |
+|------|-------------|
+| `--name` | Name of the deployment target to create (required) |
+
+```bash Create Target
+porter target create --name staging
+```
+
+On success, the command prints the new target's ID:
+
+```
+Created target with name staging and id cc1b12a3-1481-4b98-910f-12bf8c13f5d4
+```
+
+---
+
+## `porter target delete`
+
+Delete a deployment target from the current cluster. Works for both standard and preview environment targets.
+
+**Usage:**
+```bash
+porter target delete --name [name] [flags]
+```
+
+**Options:**
+
+| Flag | Description |
+|------|-------------|
+| `--name` | Name of the deployment target to delete (required) |
+| `-f`, `--force` | Skip the confirmation prompt |
+
+<CodeGroup>
+```bash Delete Target
+porter target delete --name staging
+```
+
+```bash Skip Confirmation
+porter target delete --name staging --force
+```
+</CodeGroup>
+
+<Warning>
+The default deployment target for a cluster can't be deleted. Attempting to delete it returns an error.
+</Warning>
+
+---
+
 ## Using Targets with Deployments
 
 Specify a target when deploying with `porter apply`: