---
title: "This creates a new Workflow"
method: POST
path: "/workflows"
tags: ["Data Enhancement"]
---

# This creates a new Workflow

`POST /workflows`

Creates a Workflow resource.

## Request body

- WorkflowWorkflowInputWorkflowInputCreate — Data for Workflow object. Use either only the chart attribute or WorkflowStep & WorkflowTransition, as chart has priority and will 'erase' the others
  - `id` string
  - `name` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `chart` WorkflowChart — Data Structure of the Workflow - used by MrBlenny/react-flow-chart : https://github.com/MrBlenny/react-flow-chart#example
    - `offset` object, required
    - `nodes` object, required
    - `links` object, required
    - `selected` object
    - `hovered` object
  - `steps` WorkflowStep[] — List of Workflow Steps
    - `id` string, required — This is the unique identifier of the resource
    - `name` LanguageTranslation, required — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `color` string
    - `default` boolean, required
  - `transitions` WorkflowTransition[] — List of Workflow Transitions
    - `id` string, required — This is the unique identifier of the resource
    - `name` LanguageTranslation, required — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `originStepId` string, required — Unique resource identifier for the origin Workflow Step point of the transition. It must be defined in the "steps" list
    - `targetStepId` string, required — Unique resource identifier for the target/destination Workflow Step point of the transition. It can be the same as the origin. It must be defined in the "steps" list
    - `permissionFeatures` string[]
  - `documentType` object

## Response `201`

Workflow resource created

- WorkflowWorkflowOutputWorkflowOutput — Data for Workflow object. Use either only the chart attribute or WorkflowStep & WorkflowTransition, as chart has priority and will 'erase' the others
  - `name` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `chart` WorkflowChart — Data Structure of the Workflow - used by MrBlenny/react-flow-chart : https://github.com/MrBlenny/react-flow-chart#example
    - `offset` object, required
    - `nodes` object, required
    - `links` object, required
    - `selected` object
    - `hovered` object
  - `steps` WorkflowStep[] — List of Workflow Steps
    - `id` string, required — This is the unique identifier of the resource
    - `name` LanguageTranslation, required — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `color` string
    - `default` boolean, required
  - `transitions` WorkflowTransition[] — List of Workflow Transitions
    - `id` string, required — This is the unique identifier of the resource
    - `name` LanguageTranslation, required — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
      - `fr-FR` string
      - `en-US` string
    - `originStepId` string, required — Unique resource identifier for the origin Workflow Step point of the transition. It must be defined in the "steps" list
    - `targetStepId` string, required — Unique resource identifier for the target/destination Workflow Step point of the transition. It can be the same as the origin. It must be defined in the "steps" list
    - `permissionFeatures` string[]
  - `dateCreated` string, date-time, nullable — This is an ISO datetime
  - `dateModified` string, date-time, nullable — This is an ISO datetime
  - `id` string — This is the unique identifier of the resource
  - `documentType` object
  - `legacyId` integer

## Other responses

- `400` — Invalid input
- `422` — Unprocessable entity

---

[API](https://skmtc.net/quable/apis/quable-pim-api-documentation-v5.md) · [All operations](https://skmtc.net/quable/apis/quable-pim-api-documentation-v5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quable/quable-pim-api-documentation-v5/versions/1641096abb34/schema)