Kill

Kill an execution

This task will kill an execution and optionally propagate the kill to child executions.

yaml
type: "io.kestra.plugin.kestra.executions.Kill"

Examples

Kill the current execution with propagation to child executions

yaml
id: conditional-kill-flow
namespace: company.team

inputs:
  - id: shouldKill
    type: boolean
    defaults: false

tasks:
  - id: subflow
    type: io.kestra.plugin.core.flow.Subflow
    flowId: child
    namespace: demo
    wait: false
  - id: kill
    type: io.kestra.plugin.kestra.executions.Kill
    runIf: "{{ inputs.shouldKill == true }}"
    propagateKill: true

Kill a specific execution by ID

yaml
id: kill-specific-execution
namespace: company.team

tasks:
  - id: kill_execution
    type: io.kestra.plugin.kestra.executions.Kill
    executionId: "{{ vars.targetExecutionId }}"
    propagateKill: false

Properties

auth AbstractKestraTask-Auth

Authentication information.

executionId string

The execution ID to kill

The ID of the execution to kill. If null, will kill the current execution.

kestraUrl string

Kestra API URL. If null, uses 'kestra.url' from configuration. If that is also null, defaults to 'http://localhost: 8080'.

propagateKill booleanstring

Default true

Propagate kill to child executions

Whether to also kill the child executions (subflows) when this execution is killed.

tenantId string

The tenant ID to use for the request, defaults to current tenant.

Definitions

io.kestra.plugin.kestra.AbstractKestraTask-Auth

apiToken string

API token.

password string

Password for HTTP Basic authentication.

username string

Username for HTTP Basic authentication.

​Kill

Kill