---
title: "Remove a workflow step"
method: POST
path: "/api/workflows/steps/step_removal"
tags: ["Workflows"]
---

# Remove a workflow step

`POST /api/workflows/steps/step_removal`

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/api/workflows/steps/step_removal`
- Auth: API key in header `X-API-KEY`

Remove a workflow with optional moving of items to different step(s)

## Request body

- RequestWorkflowStepRemovalResource
  - `data` WorkflowStepRemovalResource, required
    - `type` string, required
    - `relationships` WorkflowStepRemovalResourceRelationships, required
      - `changeStep` SingleRelationship, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `stepForStory` SingleRelationship, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `stepForBug` SingleRelationship, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required

## Response `200`

removeWorkflowStep 200 response

---

[API](https://skmtc.dev/atono/apis/backend-api.md) · [All operations](https://skmtc.dev/atono/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atono/apis/backend-api/revisions/78a57b1d8c3d?raw)