HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Preview what deploying this pipeline would do

Plan a deploy without performing it: what would be merged, cut, built and scheduled — and every reason it would be refused. Writes nothing. Always 200; read "ok".

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The UUID of the pipeline

Body Params
string

ref to deploy — feature// (merges then cuts), the default branch (cuts only), or release/ (as-is). Defaults to the default branch.

string

release to create — required unless source is already a release

string

how the pipeline is packaged — 'image' (default: build a frozen artifact) or 'release' (run straight from the release branch). Only those two values are accepted.

twins
object

templated pipelines only: list of hardware ids, or of {twin, target} where target is "cloud" (default) or "edge"

integer

schedule interval in ms (required)

integer

schedule delay in ms

properties
object

values for the pipeline variables

boolean

produce the pipeline's PLOT steps on each triggered run (default false). Needs every twin on the cloud target — an edge device has nowhere to publish a plot.

boolean

retrain the pipeline's models on each triggered run (default false). Needs every twin on the cloud target AND packaging 'release': a model frozen in an image cannot be replaced, so a retrained one would be silently discarded.

boolean

run the pipeline's WRITE steps (default TRUE — this is what a scheduled pipeline is normally for).

string

environment / python version, e.g. "3.12"

string

update this existing trigger instead of creating one

Response

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json