Skip to main content

Delete

expanso-cli job delete

Delete a job

Synopsis

Soft-delete a job and stop all its executions. The job data is preserved for audit purposes but excluded from default listings.

expanso-cli job delete JOB_ID_OR_NAME [flags]

Examples

  # Delete a job by name
expanso-cli job delete my-job

# Delete a job by ID
expanso-cli job delete job-abc123

# Skip confirmation prompt
expanso-cli job delete my-job --yes

# Force delete even if not in deletable state
expanso-cli job delete my-job --force

# Skip confirmation and bypass state validation
expanso-cli job delete my-job --yes --force

# Delete with a custom reason
expanso-cli job delete my-job --reason "No longer needed"

# View deleted jobs
expanso-cli job list --states deleted

Options

  -f, --force           Force deletion even if job is not in deletable state
-h, --help help for delete
--reason string Reason for deletion
-y, --yes Skip confirmation prompt

Options inherited from parent commands

      --auth-token string   API bearer authentication token
-e, --endpoint string API endpoint URL
-k, --insecure Skip TLS certificate verification
-p, --profile string Profile to use for configuration
--timeout string Request timeout duration
-v, --verbose Enable verbose logging

SEE ALSO

Auto generated by spf13/cobra on 19-Nov-2025