---
title: "Creates a Debug Flow"
method: POST
path: "/flows/start-debug"
tags: ["flows"]
---

# Creates a Debug Flow

`POST /flows/start-debug`

You need `workspaces.flow.toggleStatus` permission to access this resource

## Request body

- object
  - `data` object, required
    - `type` 'flow', required
    - `attributes` object, required
      - `name` string, required
      - `type` 'debug', required
      - `graph` object, required
        - `nodes` object[], required
          - `id` string, required
          - `fields` object, required
          - `command` string, required
          - `vpn_agent_id` string
          - `error` boolean, required
        - `edges` object[], required
          - `config` object, required
            - `mapper` object, required
            - `condition` string, nullable, required
          - `source` string, required
          - `target` string, required
      - `nodes_config` object
        - `step_id` object — The Id of flow step. Format: step_1, step_2, step_n
          - `log_level` 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' — Log level of component running in this step
    - `meta` object, required
      - `sampleData` object, required
        - `body` object, required
        - `passthrough` object, required
    - `relationships` object, required
      - `data` object, required
        - `id` string, required — Workspace ID
        - `type` 'workspace', required
      - `links` object, required
        - `self` string, required

## Response `202`

Accepted

- object
  - `data` object, required
    - `id` string, required
    - `type` 'flow', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `api_version` string, required
      - `created_at` string, date-time, required
      - `current_status` 'inactive', required
      - `default_mapper_type` 'jsonata', required
      - `description` string, nullable, required — Flow description
      - `nodes_config` object, required
      - `last_modified` string, date-time, required
      - `name` string, required
      - `status` 'inactive', required
      - `type` 'debug', required
      - `updated_at` string, date-time, required
      - `stats_enabled` boolean, required — *Flow Stats Toggle* By default each step of a flow generates stats about input/output messages and errors. You can see them on the Executions and Dashboard pages. To disable input/output message stats you can set flow's `attributes.stats_enabled` flag to `false`.
      - `timeout` integer, required
    - `relationships` object, required
      - `queue` object, required
        - `data` object, required
          - `id` string, required
          - `type` 'queue-name', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)