Skip to content
Tenzir

Update pipeline state

POST
/pipeline/update

Update the state of the pipeline. All values that are not explicitly included in the request are left in their old state.

Authorizations

Request Body required

Body for the update endpoint

object
id
required

The id of the pipeline to be updated.

string
08446737-da9b-4787-8599-97d85c48c3bb
definition

The updated definition of the pipeline.

string
export | where baz | publish /foo
action

The action that will change the pipeline’s running state.

string
Allowed values: start pause stop 
start
name

Update the human-readable name of the pipeline to this value.

string
zeek-monitoring-pipeline
labels

The user-provided labels for this pipeline.

Array<object>
object
text

The pipeline label text.

string
zeek
color

The pipeline label color.

string
3F1A24
autostart

Flags that specify on which state to restart the pipeline.

object
created

Autostart the pipeline upon creation.

boolean
true
completed

Autostart the pipeline upon completion.

boolean
failed

Autostart the pipeline upon failure.

boolean
autodelete

Flags that specify on which state to delete the pipeline.

object
completed

Autodelete the pipeline upon completion.

boolean
failed

Autodelete the pipeline upon failure.

boolean
true
stopped

Autodelete the pipeline when it stops before completing.

boolean
retry_delay

A duration string specifying the minimum time between automatic restarts of a pipeline when an error occurs. Takes no effect if restarting on failure is disabled.

string
500ms
unstoppable

A flag specifying whether this pipeline is unstoppable. Unstoppable pipelines start automatically, fail when they complete, and can not be paused or stopped manually.

boolean
true

Responses

200

Success.

The updated pipeline.

object
pipeline
object
id

The pipeline id.

string
name

The human-readable name of the pipeline.

string
definition

The pipeline definition.

string
unstoppable

A flag specifying whether this pipeline is unstoppable. Unstoppable pipelines start automatically, fail when they complete, and can not be paused or stopped manually.

boolean
true
hidden

Whether this pipeline is hidden. Hidden pipelines are only available through the show pipelines operator.

bool
created_at

The Unix timestamp of the pipeline creation time in nanoseconds.

integer format: int64
last_modified

The Unix timestamp of the last pipeline modification in nanoseconds.

integer format: int64
start_time

If the pipeline has been started, the ISO 8601 timestamp of the most recent start.

string
total_runs

The total amount of runs this pipeline has attempted so far.

integer
state
string
Allowed values: created running paused failed stopped completed
error

The error that the pipeline may have encountered during running.

string
diagnostics
Array<object>
object
severity
string
Allowed values: error warning note
message
string
unknown option `--frobnify`
annotation
Array<object>
object
primary
boolean
text

A potentially empty label.

string
this option does not exist
source

A region in the source code, defined by byte offsets.

object
begin
number
42
end
number
48
notes
Array<object>
object
kind
string
Allowed values: note usage hint docs 
usage
message
string
file <path> [-f|--follow] [-m|--mmap] [-t|--timeout <duration>]
rendered
string
error: unknown option `--frobnify`
labels

The user-provided labels for this pipeline.

Array<object>
object
text

The pipeline label text.

string
zeek
color

The pipeline label color.

string
3F1A24
retry_delay

A duration string specifying the minimum time between automatic restarts of a pipeline when an error occurs. Takes no effect if restarting on failure is disabled.

string
10s
autostart

Flags that specify on which state to restart the pipeline.

object
created

Autostart the pipeline upon creation.

boolean
true
completed

Autostart the pipeline upon completion.

boolean
failed

Autostart the pipeline upon failure.

boolean
autodelete

Flags that specify on which state to delete the pipeline.

object
completed

Autodelete the pipeline upon completion.

boolean
failed

Autodelete the pipeline upon failure.

boolean
true
stopped

Autodelete the pipeline when it stops before completing.

boolean
ttl

If a TTL exists for this pipeline, the TTL as a duration string.

string
2min
remaining_ttl

If a TTL exists for this pipeline, the remaining TTL as a duration string.

string
10s

400

Invalid arguments.

object
error
required

The error message.

string
Invalid arguments