Skip to main content

​
Overview

flytectl get retrieves information about Flyte resources from FlyteAdmin. 
flytectl get <resource> [name] -p <project> -d <domain> [flags]
All get commands support the global output flags: -o TABLE (default), -o json, -o yaml.

​
Subcommands

SubcommandAliasesDescription
get projectprojectsList or inspect Flyte projects
get workflowworkflowsList or inspect workflow versions
get tasktasksList or inspect task versions
get launchplanlaunchplansList or inspect launch plan versions
get executionexecutionsList or inspect workflow executions
get task-resource-attributetask-resource-attributesFetch task resource attribute overrides
get cluster-resource-attributecluster-resource-attributesFetch cluster resource attribute overrides
get execution-cluster-labelexecution-cluster-labelsFetch execution cluster label overrides
get execution-queue-attributeexecution-queue-attributesFetch execution queue attribute overrides
get plugin-overrideplugin-overridesFetch plugin override settings
get workflow-execution-configFetch workflow execution config overrides

​
get project

Fetch all registered projects or a specific project by ID. 
# List all projects
flytectl get project

# Get a project by ID
flytectl get project flytesnacks

# Filter by name
flytectl get project --filter.fieldSelector="project.name=flytesnacks"

# Paginate results
flytectl get project --filter.limit=10 --filter.page=2

# Sort results
flytectl get project --filter.sortBy=created_at --filter.limit=1 --filter.asc

# YAML output
flytectl get project -o yaml

# JSON output
flytectl get project -o json
Output columns: ID, Name, Description

​
get workflow

Fetch workflow definitions within a project and domain. 
# List all workflows (returns named entity list)
flytectl get workflow -p flytesnacks -d development

# List all versions of a named workflow
flytectl get workflow -p flytesnacks -d development core.basic.lp.go_greet

# Fetch the latest version
flytectl get workflow -p flytesnacks -d development core.basic.lp.go_greet --latest

# Fetch a specific version
flytectl get workflow -p flytesnacks -d development core.basic.lp.go_greet --version v2

# Filter workflows
flytectl get workflow -p flytesnacks -d development \
  --filter.fieldSelector="workflow.name=k8s_spark.dataframe_passing.my_smart_schema"

# Paginate
flytectl get workflow -p flytesnacks -d development --filter.limit=10 --filter.page=2

# Visualize the workflow graph as DOT
flytectl get workflow -p flytesnacks -d development \
  core.flyte_basics.basic_workflow.my_wf --latest -o dot

# Render DOT in browser
flytectl get workflow -p flytesnacks -d development \
  core.flyte_basics.basic_workflow.my_wf --latest -o doturl
Flags:
FlagDescription
--latestFetch the latest version
--versionFetch a specific version (e.g. v2)
--filter.fieldSelectorFilter expression (e.g. workflow.name=foo)
--filter.sortBySort field (e.g. created_at)
--filter.limitMaximum number of results per page
--filter.pagePage number to retrieve
--filter.ascSort in ascending order
-o dot and -o doturl are only supported for workflows.

​
get task

Fetch task definitions within a project and domain. 
# List all tasks
flytectl get task -p flytesnacks -d development

# List all versions of a named task
flytectl get task -p flytesnacks -d development core.basic.lp.greet

# Fetch the latest version
flytectl get task -p flytesnacks -d development core.basic.lp.greet --latest

# Fetch a specific version
flytectl get task -p flytesnacks -d development core.basic.lp.greet --version v2

# Filter tasks
flytectl get task -p flytesnacks -d development \
  --filter.fieldSelector="task.name=k8s_spark.pyspark_pi.print_every_time,task.version=v1"

# Generate an execution spec file for launching the task
flytectl get task -d development -p flytesnacks \
  core.control_flow.merge_sort.merge --execFile execution_spec.yaml --version v2
Flags:
FlagDescription
--latestFetch the latest version
--versionFetch a specific version
--execFileWrite an execution spec YAML to this file path
--filter.fieldSelectorFilter expression
--filter.sortBySort field
--filter.limitMaximum number of results per page
--filter.pagePage number to retrieve
Generated execution spec (execution_spec.yaml): 
iamRoleARN: ""
inputs:
  sorted_list1:
  - 0
  sorted_list2:
  - 0
kubeServiceAcct: ""
targetDomain: ""
targetProject: ""
task: core.control_flow.merge_sort.merge
version: v2
Pass this file to flytectl create execution --execFile execution_spec.yaml to launch the task.

​
get launchplan

Fetch launch plan definitions within a project and domain. 
# List all launch plans
flytectl get launchplan -p flytesnacks -d development

# List all versions of a named launch plan
flytectl get launchplan -p flytesnacks -d development core.basic.lp.go_greet

# Fetch the latest version
flytectl get launchplan -p flytesnacks -d development core.basic.lp.go_greet --latest

# Fetch a specific version
flytectl get launchplan -p flytesnacks -d development core.basic.lp.go_greet --version v2

# Fetch all launch plans for a workflow
flytectl get launchplan -p flytesnacks -d development \
  --workflow core.flyte_basics.lp.go_greet

# List only active launch plans
flytectl get launchplan -p flytesnacks -d development -o yaml \
  --filter.fieldSelector "state=1"

# List only archived launch plans
flytectl get launchplan -p flytesnacks -d development -o yaml \
  --filter.fieldSelector "state=0"

# Generate an execution spec file
flytectl get launchplan -d development -p flytesnacks \
  core.control_flow.merge_sort.merge_sort --execFile execution_spec.yaml
Flags:
FlagDescription
--latestFetch the latest version
--versionFetch a specific version
--workflowFilter by workflow name
--execFileWrite an execution spec YAML to this file path
--filter.fieldSelectorFilter expression
Generated execution spec (execution_spec.yaml): 
iamRoleARN: ""
inputs:
  numbers:
  - 0
  numbers_count: 0
  run_local_at_count: 10
kubeServiceAcct: ""
targetDomain: ""
targetProject: ""
version: v3
workflow: core.control_flow.merge_sort.merge_sort

​
get execution

Fetch workflow executions within a project and domain. 
# List all executions
flytectl get execution -p flytesnacks -d development

# Get a specific execution by name
flytectl get execution -p flytesnacks -d development oeh94k9r2r

# Filter by phase
flytectl get execution -p flytesnacks -d development \
  --filter.fieldSelector="execution.phase in (FAILED;SUCCEEDED),execution.duration<200"

# Paginate
flytectl get execution -p flytesnacks -d development \
  --filter.limit=10 --filter.page=2

# Sort results
flytectl get execution -p flytesnacks -d development \
  --filter.sortBy=created_at --filter.limit=1 --filter.asc

# JSON output
flytectl get execution -p flytesnacks -d development -o json

# YAML output
flytectl get execution -p flytesnacks -d development -o yaml

# Show node and task execution details (tree view)
flytectl get execution -p flytesnacks -d development oeh94k9r2r --details

# Show details in YAML (node-level only)
flytectl get execution -p flytesnacks -d development oeh94k9r2r --details -o yaml

# Inspect a specific node
flytectl get execution -p flytesnacks -d development oeh94k9r2r --nodeID n0

# Inspect a node in YAML (includes inputs and outputs)
flytectl get execution -p flytesnacks -d development oeh94k9r2r --nodeID n0 -o yaml
Flags:
FlagDescription
--detailsShow node and task execution tree
--nodeIDFetch task executions for a specific node ID
--filter.fieldSelectorFilter expression
--filter.sortBySort field
--filter.limitMaximum number of results per page
--filter.pagePage number
--filter.ascSort ascending
Output columns: Name, Launch Plan Name, Version, Type, Phase, Scheduled Time, Started, Elapsed Time, Abort data, Error data
--details does not support TABLE format. If -o TABLE is used with --details, flytectl falls back to tree view automatically.

​
Matchable attribute subcommands

These subcommands fetch resource overrides that can be applied at project, project+domain, or project+domain+workflow scope. 
flytectl get task-resource-attribute -p flytesnacks -d development
flytectl get task-resource-attribute -p flytesnacks -d development --attrFile tra.yaml

flytectl get cluster-resource-attribute -p flytesnacks -d development
flytectl get cluster-resource-attribute -p flytesnacks -d development --attrFile cra.yaml

flytectl get execution-cluster-label -p flytesnacks -d development
flytectl get execution-cluster-label -p flytesnacks -d development --attrFile ecl.yaml

flytectl get execution-queue-attribute -p flytesnacks -d development

flytectl get plugin-override -p flytesnacks -d development

flytectl get workflow-execution-config -p flytesnacks -d development

Build docs developers (and LLMs) love

Get started for freeTalk to us