---
title: "POST /workflowstep"
method: POST
path: "/workflowstep"
---

# POST /workflowstep

`POST /workflowstep`

Create a step in the migration workflow.

## Request body

- object
  - `name` string, required — The name of the step.
  - `stepGroupId` string, required — The ID of the step group.
  - `workflowId` string, required — The ID of the migration workflow.
  - `stepActionType` 'MANUAL' | 'AUTOMATED', required — The action type of the step. You must run and update the status of a manual step for the workflow to continue after the completion of the step.
  - `description` string — The description of the step.
  - `workflowStepAutomationConfiguration` object — The custom script to run tests on source or target environments.
    - `scriptLocationS3Bucket` string — The Amazon S3 bucket where the script is located.
    - `scriptLocationS3Key` object — The Amazon S3 key for the script location.
      - `linux` string — The script location for Linux.
      - `windows` string — The script location for Windows.
    - `command` object — The command required to run the script.
      - `linux` string — Command for Linux.
      - `windows` string — Command for Windows.
    - `runEnvironment` 'AWS' | 'ONPREMISE' — The source or target environment.
    - `targetType` 'SINGLE' | 'ALL' | 'NONE' — The servers on which to run the script.
  - `stepTarget` StringListMember[] — The servers on which a step will be run.
  - `outputs` WorkflowStepOutput[] — The key value pairs added for the expected output.
    - `name` string — The name of the step.
    - `dataType` 'STRING' | 'INTEGER' | 'STRINGLIST' | 'STRINGMAP' — The data type of the output.
    - `required` boolean — Determine if an output is required from a step.
    - `value` object — The value of the output.
      - `integerValue` integer — The integer value.
      - `stringValue` string — The string value.
      - `listOfStringValue` MaxStringValue[] — The list of string value.
  - `previous` StringListMember[] — The previous step.
  - `next` StringListMember[] — The next step.

## Response `200`

Success

- CreateWorkflowStepResponse
  - `id` string — The ID of the step.
  - `stepGroupId` string — The ID of the step group.
  - `workflowId` string — The ID of the migration workflow.
  - `name` string — The name of the step.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/migrationhuborchestrator.md) · [All operations](https://skmtc.net/aws/apis/migrationhuborchestrator/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/migrationhuborchestrator/versions/d388f030f5e3/schema)