Skip to content
CodeTeleport

codeteleport delete

Synopsis

Section titled “Synopsis”
Terminal window
codeteleport delete <session-id> [-y | --yes]

Description

Section titled “Description”

The delete command permanently removes a session from CodeTeleport cloud storage. This deletes both the session metadata and the uploaded bundle. The operation cannot be undone.

By default, the command asks for confirmation before deleting. The confirmation prompt defaults to deny — you must explicitly type y to proceed:

Delete session a1b2c3d4-e5f6-7890-abcd-ef1234567890? (y/N)

Any response other than y (including pressing Enter with no input) cancels the deletion.

Flags

Section titled “Flags”
FlagDescription
<session-id>(required) The full session ID to delete. You can find session IDs with codeteleport list --cloud.
-y, --yesSkip the confirmation prompt. Useful for scripting and automation.

Examples

Section titled “Examples”

Delete with confirmation

Section titled “Delete with confirmation”
$ codeteleport delete a1b2c3d4-e5f6-7890-abcd-ef1234567890
Delete session a1b2c3d4-e5f6-7890-abcd-ef1234567890? (y/N) y
Session a1b2c3d4-e5f6-7890-abcd-ef1234567890 deleted.

Cancel a deletion

Section titled “Cancel a deletion”
$ codeteleport delete a1b2c3d4-e5f6-7890-abcd-ef1234567890
Delete session a1b2c3d4-e5f6-7890-abcd-ef1234567890? (y/N) n
Cancelled.

Skip confirmation with —yes

Section titled “Skip confirmation with —yes”
$ codeteleport delete a1b2c3d4-e5f6-7890-abcd-ef1234567890 --yes
Session a1b2c3d4-e5f6-7890-abcd-ef1234567890 deleted.

Delete in a script

Section titled “Delete in a script”
# Delete all sessions from a specific machine
codeteleport list --cloud --machine old-laptop --json \
  | jq -r '.[].id' \
  | xargs -I {} codeteleport delete {} --yes

Session not found

Section titled “Session not found”
$ codeteleport delete nonexistent-session-id --yes
Delete failed: Session not found
Section titled “Related commands”