---
title: How to create a workflow using Data Orchestrator
description: This page explains how to create a Data Orchestrator workflow on the Scaleway console.
tags: data-orchestrator workflow create upload
dates:
  posted: 2026-04-01
---
import Requirements from '@macros/iam/requirements.mdx'
import UploadWorkflow from '@macros/data-orchestrator/upload-workflow.mdx'
import RunWorkflow from '@macros/data-orchestrator/run-workflow.mdx'
import BetaNoteDataOrc from '@macros/data-orchestrator/beta-note.mdx'

<BetaNoteDataOrc />

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- A [Container Registry namespace](/container-registry/how-to/create-namespace/)
- An image [pushed](/container-registry/how-to/push-images/) to your namespace (for task execution)
- Created at least three [Serverless Jobs](/serverless-jobs/how-to/create-job/)
- Basic familiarity with YAML syntax
- Basic familiarity with [Serverless workflow.io](https://serverlessworkflow.io/) language

## Create a workflow definition YAML file

Data Orchestrator requires the user to upload a YAML file to use as a workflow definition.

<Message type="tip">
  This is a basic example of a sequential workflow using three Serverless Jobs. For more examples, see the [Action tasks](/data-orchestrator/reference-content/action-tasks/) and [Logic tasks](/data-orchestrator/reference-content/logic-tasks/) documentation.
</Message>

1. Create a YAML file, copy and paste the following content into the file.
    ```yaml
    document:
      dsl: 1.0.3
      namespace: <namespace_name>
      name: <workflow_name>
      version: 1.0.0
    do:
    - task1:
        call: "serverless_job"
        metadata:
          description: "The first job"
        with:
          id: "<Serverless_job1_ID>"
          region: "fr-par"
    - task2:
        call: "serverless_job"
        metadata:
          description: "The second job"
        with:
          id: "<Serverless_job2_ID>"
          region: "fr-par"
    - task3:
        call: "serverless_job"
        metadata:
          description: "The third job"
        with:
          id: "<Serverless_job3_ID>"
          region: "fr-par"
    ```
2. Replace the ID placeholders with the IDs of your Serverless Jobs. You can copy them from the [Serverless Jobs page](https://console.scaleway.com/serverless-jobs/) of the console.
    <Message type="note">
      The fields `namespace` and `name` are required. They can be used as metadata to help organize your YAML files. For more details, see the [Workflow definition properties](#workflow-definition-properties) table.
    </Message>
3. Save the YAML file.

### Workflow definition properties

| Property&nbsp;name |         Type         | Required |                         Description                          |
| :----------------- | :------------------: | :------: | :----------------------------------------------------------- |
| `dsl`              |        string        |   yes    | The version of the DSL used to define the workflow.          |
| `namespace`        |        string        |   yes    | The namespace of the workflow.                               |
| `name`             |        string        |   yes    | The name of the workflow..                                   |
| `version`          |        string        |   yes    | The [semantic version](https://semver.org/) of the workflow. |
| `title`            |        string        |    no    | The title of the workflow..                                  |
| `summary`          |        string        |    no    | The Markdown summary of the workflow..                       |
| `tags`             | map [string, string] |    no    | A key/value mapping of the tags of the workflow., if any.    |
| `metadata`         |         map          |    no    | Additional information about the workflow.                   |

## Create a Data Orchestrator workflow

1. Click **Data Orchestrator** in the **Data & Analytics** section of the [console](https://console.scaleway.com/) side menu. The list of your workflows displays.
2. Click **+ Create workflow**. The Data Orchestrator workflow creation wizard displays.
3. Select the region in which your workflow will be created.
4. Enter a name or use the automatically generated one.
5. Enter a description (optional).
6. Click **Create workflow only** to finish, or click **Create workflow and add tasks** to upload a workflow definition file next.

## Upload the workflow definition

<UploadWorkflow />

## Run a workflow

<RunWorkflow />