admin-resource5

API Gateway26

application-resource15

audit-resource3

authorization-resource5

business-rule-resource10

context-controller1

environment-resource7

event-execution-resource2

event-message-resource2

event-resource16

global-schema-resource2

group-resource10

health-check-resource1

human-task14

human-task-resource1

incoming-webhook-resource2

integration-resource26

limits-resource1

LLM3

metadata-resource12

metrics-resource1

org-config-resource1

orkes-agent-controller39

prompt-resource14

provider-controller1

queue-admin-resource2

role-resource9

scheduler-bulk-resource2

scheduler-resource18

schema-resource6

secret-resource13

service-registry-resource15

sharing-resource3

tags11

task-resource18

token-resource2

user-form6

user-form-template-resource3

user-resource6

version-resource1

webhooks-config-resource8

workflow-bulk-resource6

workflow-resource31

metadata-resource

Create a new workflow definition

Changed on Oct 10, 2026

post/api/metadata/workflow

Request

Base URL
https://developer.orkescloud.com
Auth
API key in header X-Authorization
TypeScript
https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/docs/api/metadata/workflow/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

overwriteboolean

newVersionboolean

Request body

createTimeinteger

createdBystring

descriptionstring

enforceSchemaboolean

failureWorkflowstring

failureWorkflowVersioninteger

inputParametersstring[]

inputTemplateobject

maskedFieldsstring[]

metadataobject

namestring

outputParametersobject

overwriteTagsboolean

ownerAppstring

ownerEmailstring

restartableboolean

schemaVersioninteger

timeoutPolicy'TIME_OUT_WF' | 'ALERT_ONLY'

timeoutSecondsinteger required

updateTimeinteger

updatedBystring

variablesobject

versioninteger

workflowStatusListenerEnabledboolean

workflowStatusListenerSinkstring

Response

object required

Changes

Oct 10, 2026a142cbe9d486 Revision changes
- breaking
  added the new required request property /////
- breaking
  the request's body type changed from no type to object
- breaking
  the request property's minItems was increased to 1
- breaking
  the request property's minLength was increased from 0 to 1
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  the /// request property's minLength was increased from 0 to 1
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  the request property type changed from no type to object
- breaking
  the request property type changed from no type to object
- breaking
  the request property type changed from no type to object
- breaking
  the request property type changed from no type to object
- breaking
  the / request property type changed from no type to object
- breaking
  the / request property type changed from no type to object
- breaking
  the // request property type changed from no type to object
- breaking
  the //// request property type changed from no type to object
- breaking
  the // request property type changed from no type to object
- breaking
  the // request property type changed from no type to object
- breaking
  the /// request property type changed from no type to object
- breaking
  the /// request property type changed from no type to object
- warning
  the request property's max was set to 2.00
- warning
  the request property's min was set to 2.00
- warning
  the /// request property's min was set to 0.00
- warning
  the /// request property's min was set to 1.00
- warning
  the /// request property's min was set to 0.00
- warning
  the /// request property's min was set to 0.00
- warning
  the /// request property's min was set to 1.00
- warning
  the /// request property's min was set to 0.00
- warning
  the /// request property's min was set to 0.00
- info
  added the new optional request property /////
- info
  the request property became optional
- info
  the request property // became optional
- info
  the request property /// became optional
- info
  the request property // became optional

Operation history