---
title: "POST /ver2/WorkflowService.svc/workflows/{workflowIdOrUniqueId}/children"
method: POST
path: "/ver2/WorkflowService.svc/workflows/{workflowIdOrUniqueId}/children"
tags: ["Workflow"]
---

# POST /ver2/WorkflowService.svc/workflows/{workflowIdOrUniqueId}/children

`POST /ver2/WorkflowService.svc/workflows/{workflowIdOrUniqueId}/children`

## Request

- Base URL: `https://api.enviance.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.enviance.com/ver2/WorkflowService.svc/workflows/{workflowIdOrUniqueId}/children`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enviance/apis/restapi/docs/ver2/WorkflowService.svc/workflows/:workflowIdOrUniqueId/children/post.ts> (a function with typed inputs; its response is checked against the schema)

Executes a Workflow Initiator action on the active Step of an existing Workflow, thereby creating a new child Workflow, and places the child on its Init Step. Information about Form Field values and Step Actions may optionally be specified in order to update or take action on the Init Step of the child Workflow.

**Security:** Allowed for Users with Manage Workflows right or "Report" permission on the Workflow, or User in "Workflow Managers" role of WF, or User with "Manage Workflows" on any objects associated with the workflow.

**SDK API:**  `envianceSdk.workflows.initiateChildWorkflow(workflowIdOrUniqueId, childWorkflowInitiationInfo, onsuccess, onerror)`
null


envianceSdk.workflows.initiateChildWorkflow
```
[
  "B5E7E7A4-D294-4D7C-ABC9-008EDBE97346",
  {
    "parentStepIdOrName": "Step1",
    "initiatorIdOrName": "fc621b5a-739f-4cb7-9635-cb9d17f4cef6",
    "childWorkflowInfo": {
      "dueDate": "2012-09-19T18:00:00",
      "parentWorkflowSourceCustomField": {
        "id": null,
        "name": "UDF name"
      },
      "name": "test",
      "uniqueId": "1347398349600",
      "objects": [
        "/Generation - 1/NE TV"
      ]
    }
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.workflows.initiateChildWorkflow21
```
[
  "B5E7E7A4-D294-4D7C-ABC9-008EDBE97346",
  {
    "parentStepIdOrName": "Step1",
    "initiatorIdOrName": "fc621b5a-739f-4cb7-9635-cb9d17f4cef6",
    "childWorkflowInfo": {
      "dueDate": "2012-09-19T18:00:00",
      "parentWorkflowSourceCustomField": {
        "id": null,
        "name": "UDF name"
      },
      "name": "test",
      "uniqueId": "1347398349600",
      "objects": [
        "/Generation - 1/NE TV"
      ],
      "documents": [
        {
          "documentIdOrPath": "Folder1Document1.txt"
        },
        {
          "documentIdOrPath": "Folder1Document2.txt",
          "customFieldIdOrName": "udf-textbox-numeric"
        }
      ]
    }
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.workflows.initiateChildWorkflow21Ext
```
[
  {
    "workflowIdOrUniqueId": "B5E7E7A4-D294-4D7C-ABC9-008EDBE97346",
    "childWorkflowInitiationInfo": {
      "parentStepIdOrName": "Step1",
      "initiatorIdOrName": "fc621b5a-739f-4cb7-9635-cb9d17f4cef6",
      "childWorkflowInfo": {
        "dueDate": "2012-09-19T18:00:00",
        "parentWorkflowSourceCustomField": {
          "id": null,
          "name": "UDF name"
        },
        "name": "test",
        "uniqueId": "1347398349600",
        "objects": [
          "/Generation - 1/NE TV"
        ],
        "documents": [
          {
            "documentIdOrPath": "Folder1Document1.txt"
          },
          {
            "documentIdOrPath": "Folder1Document2.txt",
            "customFieldIdOrName": "udf-textbox-numeric"
          }
        ]
      }
    },
    "clientRequestId": "64AA5290-15F2-451B-9EF3-4494F66FE48F"
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.workflows.initiateChildWorkflowExt
```
[
  {
    "workflowIdOrUniqueId": "eccd2310-9b5f-440b-bf0d-91f9803d036b",
    "childWorkflowInitiationInfo": {
      "parentStepIdOrName": "Step1",
      "initiatorIdOrName": "fc621b5a-739f-4cb7-9635-cb9d17f4cef6",
      "childWorkflowInfo": {
        "dueDate": "2012-09-19T18:00:00",
        "parentWorkflowSourceCustomField": {
          "id": null,
          "name": "UDF name"
        },
        "name": "test",
        "uniqueId": "1347398349600",
        "objects": [
          "/Generation - 1/NE TV"
        ]
      }
    },
    "clientRequestId": "64AA5290-15F2-451B-9EF3-4494F66FE59E"
  },
  "onsuccess",
  "onerror"
]
```

## Path parameters

- `workflowIdOrUniqueId` string, required

## Headers

- `EnvApi-Systemid` string
- `EnvApi-Packageid` string
- `EnvApi-Udf-DateTime-Iso-In-CustomFields` string
- `EnvApi-Udf-DateTime-ReadInUserTz` string
- `EnvApi-Udf-Value-Invariant` string
- `EnvApi-Localization-All` string
- `x-client-request-id` string

## Request body

- InitiateChildWorkflow
  - `childWorkflowInitiationInfo` EnvianceRestServicesVer2WorkflowsChildWorkflowInitiationInfo
    - `parentStepIdOrName` string
    - `initiatorIdOrName` string
    - `childWorkflowInfo` EnvianceRestServicesVer2WorkflowsWorkflowInfo
      - `id` string, guid
      - `uniqueId` string
      - `name` string
      - `workflowTypeName` string
      - `parentUniqueId` string, guid
      - `parentWorkflowSourceCustomField` EnvianceRestServicesCommonCustomFieldInfo
        - `id` string, guid
        - `name` string
      - `dueDate` string, date-time
      - `status` string
      - `creator` string
      - `created` string, date-time
      - `lastRun` string, date-time
      - `assignedBy` string
      - `assignedTo` EnvianceRestServicesCommonAssigneeV2[]
        - `userIdOrName` string
        - `groupIdOrName` string
      - `objects` string[]
      - `documents` string[]
      - `calendars` string[]
      - `comment` string
      - `closeDate` string, date-time
      - `jsonData` object
    - `childInitStepInfo` EnvianceRestServicesVer2WorkflowsWorkflowStepInfo
      - `id` string, guid
      - `name` string
      - `comment` string
      - `fields` EnvianceRestServicesUdfsProperty[]
        - `name` string
        - `urlItems` EnvianceBusinessUdfRestUrlItem[]
          - `label` string
          - `url` string
        - `values` string[]
        - `beginDate` string, date-time
        - `endDate` string, date-time
        - `caption` string
        - `captionLocalized` string
      - `transition` EnvianceRestServicesVer2WorkflowsTransition
        - `stepActionName` string
        - `assignTo` EnvianceRestServicesCommonAssigneeV2[]
          - `userIdOrName` string
          - `groupIdOrName` string
        - `dueDate` string, date-time
        - `closeDate` string, date-time
      - `taskCompletion` EnvianceRestServicesVer2TasksTaskOccurrenceInfo[]
        - `statusChangeDate` string, date-time
        - `objectIdOrPath` string
        - `dismissed` boolean
        - `percentComplete` string, byte
        - `hoursToComplete` number, double
        - `costToComplete` number
        - `comment` string
        - `eventInstanceId` string, guid
        - `compliancePeriodStartDate` string, date-time
        - `compliancePeriodEndDate` string, date-time
        - `comply` string
        - `ObjectId` string, guid

## Response `default`

not available

- string, guid

---

[API](https://skmtc.dev/enviance/apis/restapi.md) - [All operations](https://skmtc.dev/enviance/apis/restapi/llms.txt) - [OpenAPI document](https://skmtc.dev/enviance/apis/restapi/revisions/45b2200a8cf2?raw)