---
title: "Create a new workflow graph as a draft"
slug: "create-a-new-workflow-graph-as-a-draft"
updated: 2026-04-04T02:22:39Z
published: 2026-04-04T02:22:47Z
canonical: "support.fortanix.com/create-a-new-workflow-graph-as-a-draft"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.fortanix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new workflow graph as a draft

Post/v1/workflows/draft/graphs

SecurityAPI Key: bearerTokenHeader parameter nameAuthentication

A JWT bearer token to be passed once authenticated.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='7c135b47-7b51-4fc6-8eb5-b5f0e283814a'>application/json</option>
</select>Expand Allobject  

Request to create a workflow graph.

namestring    Required
descriptionstring    Required
group_idstring  (uuid)    
objectsobject  Requiredproperty*object (WorkflowObject)  additionalPropertiesnamestring    Required
user_idstring  (uuid)    
descriptionstring    
refobject (WorkflowObjectRef)  Requiredplaceholderobject (WorkflowObjectRefPlaceholder)  kindstring    RequiredValid values[
  "dataset",
  "app",
  "script"
]
acct_idstring  (uuid)    
group_idstring  (uuid)    

datasetobject (WorkflowObjectRefDataset)  dataset_idstring  (uuid)    Required
acct_idstring  (uuid)    
group_idstring  (uuid)    

appobject (WorkflowObjectRefApp)  image_idstring  (uuid)    Required
config_idstring    Required
acct_idstring  (uuid)    
group_idstring  (uuid)    

edgesobject  Requiredproperty*object (WorkflowEdge)  additionalPropertiessourceobject (WorkflowEdgeLink)  Requiredidstring    Required
portstring    

targetobject (WorkflowEdgeLink)  Requiredidstring    Required
portstring    

metadataobject (WorkflowMetadata)  nodesobject  Requiredproperty*object  additionalProperties

parentobject (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_idstring  (uuid)    Required
source_versioninteger    Required

projectstring    

labelsobject  property*string    additionalProperties

Responses200<select class='api-response-data' aria-label='Media type'><option value='2992d1bf-0d37-426c-ac3b-783255d1f4c8'>application/json</option>
</select>Expand Allobject  graph_idstring  (uuid)    
namestring    
creator_idstring  (uuid)    
created_atinteger  (int64)    

Dataset creation time (seconds since epoch).

updated_atinteger  (int64)    

Last update UNIX timestamp (seconds since epoch).

descriptionstring    
versioninteger    
group_idstring  (uuid)    
acct_idstring  (uuid)    
objectsobject  property*object (WorkflowObject)  additionalPropertiesnamestring    
user_idstring  (uuid)    
descriptionstring    
refobject (WorkflowObjectRef)  placeholderobject (WorkflowObjectRefPlaceholder)  kindstring    Valid values[
  "dataset",
  "app",
  "script"
]
acct_idstring  (uuid)    
group_idstring  (uuid)    

datasetobject (WorkflowObjectRefDataset)  dataset_idstring  (uuid)    
acct_idstring  (uuid)    
group_idstring  (uuid)    

appobject (WorkflowObjectRefApp)  image_idstring  (uuid)    
config_idstring    
acct_idstring  (uuid)    
group_idstring  (uuid)    

edgesobject  property*object (WorkflowEdge)  additionalPropertiessourceobject (WorkflowEdgeLink)  idstring    
portstring    

targetobject (WorkflowEdgeLink)  idstring    
portstring    

metadataobject (WorkflowMetadata)  nodesobject  property*object  additionalProperties

parentobject (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_idstring  (uuid)    
source_versioninteger    

projectstring    

labelsobject  property*string    additionalProperties

typestring    

Workflow is owned or Shared

Valid values[
  "OWNED",
  "SHARED"
]