Create a finalized workflow graph request via approval.

  • Published on Sep 3, 2025
  • 1 minute(s) read
Prev Next
Post
/v1/workflows/final/graphs
Security
API Key: bearerToken
Header parameter nameAuthentication

A JWT bearer token to be passed once authenticated.

Body parameters
Expand All
object
name
string Required
description
string Required
group_id
string (uuid)
contents
object (CreateWorkflowVersionRequest) Required
objects
object Required
property*
object (WorkflowObject) additionalProperties
name
string Required
user_id
string (uuid)
description
string
ref
object (WorkflowObjectRef) Required
placeholder
object (WorkflowObjectRefPlaceholder)
kind
string Required
Valid values[ "dataset", "app", "script" ]
acct_id
string (uuid)
group_id
string (uuid)
dataset
object (WorkflowObjectRefDataset)
dataset_id
string (uuid) Required
acct_id
string (uuid)
group_id
string (uuid)
app
object (WorkflowObjectRefApp)
image_id
string (uuid) Required
config_id
string Required
acct_id
string (uuid)
group_id
string (uuid)
edges
object Required
property*
object (WorkflowEdge) additionalProperties
source
object (WorkflowEdgeLink) Required
id
string Required
port
string
target
object (WorkflowEdgeLink) Required
id
string Required
port
string
metadata
object (WorkflowMetadata)
nodes
object Required
property*
object additionalProperties
parent
object (WorkflowLinkMetadata)

The final workflow from which this draft was derived. This field may point to a deleted final workflow in which you should treat it as if it's not present.

graph_id
string (uuid) Required
source_version
integer Required
project
string
labels
object
property*
string additionalProperties
Responses
200
Expand All
object
graph_id
string (uuid)
name
string
group_id
string (uuid)
acct_id
string (uuid)
created_at
integer (int64)

Dataset creation time (seconds since epoch).

updated_at
integer (int64)

Last update UNIX timestamp (seconds since epoch).

description
string
versions
object
property*
object (FinalWorkflowGraph) additionalProperties
created_at
integer (int64)

Dataset creation time.

objects
object
property*
object (WorkflowObject) additionalProperties
name
string
user_id
string (uuid)
description
string
ref
object (WorkflowObjectRef)
placeholder
object (WorkflowObjectRefPlaceholder)
kind
string
Valid values[ "dataset", "app", "script" ]
acct_id
string (uuid)
group_id
string (uuid)
dataset
object (WorkflowObjectRefDataset)
dataset_id
string (uuid)
acct_id
string (uuid)
group_id
string (uuid)
app
object (WorkflowObjectRefApp)
image_id
string (uuid)
config_id
string
acct_id
string (uuid)
group_id
string (uuid)
edges
object
property*
object (WorkflowEdge) additionalProperties
source
object (WorkflowEdgeLink)
id
string
port
string
target
object (WorkflowEdgeLink)
id
string
port
string
metadata
object (WorkflowMetadata)
nodes
object
property*
object additionalProperties
parent
object (WorkflowLinkMetadata)

The final workflow from which this draft was derived. This field may point to a deleted final workflow in which you should treat it as if it's not present.

graph_id
string (uuid)
source_version
integer
project
string
runtime_configs
object
property*
object (WorkflowObjectFinalApp) additionalProperties
image_id
string (uuid)
config_id
string
deployment
object (WorkflowAppDeployment)

Deployment info for an app. Exactly one of kubernetes or aci field must be set.

kubernetes
object (WorkflowAppKubernetes)
job_spec
object
aci
object (WorkflowAppAci)
exposed_ports
Array of object (DockerNetworkPort)

List of ports exposed for the azure container instance.

object

A port exposed by a docker container.

port
integer

A valid, specific port number from 1..65535 (inclusive).

protocol
string

Protocol Associated with a Port exposed by a docker container.

Valid values[ "Tcp", "Udp" ]
env_vars
object
property*
string additionalProperties
child_nodes
Array of string
string
deployment
object (WorkflowDeployment)

Deployment info for a workflow. Exactly one of kubernetes_single_job or aci_single_job field must be set.

kubernetes_single_job
object (KubernetesSingleJob)
namespace
string
cluster_id
string (uuid)
aci_single_job
object (AciSingleJob)
cluster_id
string (uuid)
deployment_location
string
labels
object
property*
string additionalProperties
type
string

Workflow is owned or Shared

Valid values[ "OWNED", "SHARED" ]