---
updatedAt: 2026-06-11T21:38:37.000Z
agentTools:
  projectIndex: https://docs.atono.io/llms.txt
---

# Get a workflow step

Use this endpoint to inspect the configuration of a specific workflow step—for example, when resolving a `workflowStep` relationship returned in a story or bug response.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Atono API",
    "version": "0.1"
  },
  "servers": [
    {
      "url": "https://api.atono.io",
      "description": "Atono API"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "paths": {
    "/api/v1/workflow-steps/{id}": {
      "get": {
        "tags": [
          "Workflow Steps"
        ],
        "summary": "Get a workflow step",
        "operationId": "fetchWorkflowStep",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The UUID of the workflow step.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved the workflow step.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SingleResourceBody_WorkflowStepResourceV1_"
                }
              }
            },
            "links": {
              "self": {
                "operationId": "fetchWorkflowStep",
                "parameters": {
                  "id": "$response.body#/data/id"
                }
              }
            }
          },
          "404": {
            "description": "The workflow step could not be found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NoResourceBody"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "NoResourceBody": {
        "properties": {
          "errors": {
            "type": "array",
            "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.",
            "items": {
              "$ref": "#/components/schemas/ProblemDetail",
              "description": "A problem detail object is a way to convey information about an error that occurred while processing a request."
            }
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values."
          },
          "included": {
            "type": "array",
            "description": "A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).",
            "items": {}
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`."
          }
        },
        "readOnly": true
      },
      "ProblemDetail": {
        "description": "A problem detail object is a way to convey information about an error that occurred while processing a request.",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this specific error occurrence. Useful for debugging and support."
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "allOf": [
              {
                "type": [
                  "null",
                  "object"
                ]
              }
            ],
            "description": "Links related to the error. May include a URL to relevant documentation or support resources."
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "description": "The HTTP status code associated with the error (e.g., 400, 404, 422)."
          },
          "code": {
            "type": "string",
            "description": "An internal code that identifies the type or category of the error."
          },
          "title": {
            "type": "string",
            "description": "A short summary of the problem."
          },
          "source": {
            "type": [
              "null",
              "object"
            ],
            "allOf": [
              {
                "$ref": "#/components/schemas/ProblemSource"
              }
            ],
            "readOnly": true
          },
          "detail": {
            "type": "string",
            "description": "Additional information about the error, intended to provide more context than the title."
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional information about the error, which may be useful for debugging. The contents vary depending on the error type."
          }
        },
        "readOnly": true
      },
      "ProblemSource": {
        "description": "Identifies the part of the request that caused the error. Only one source is present per error.",
        "properties": {
          "pointer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Specifies the path to the field in the request body that caused the error."
          },
          "parameter": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifies a query parameter in the request URL that caused the error."
          },
          "header": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifies the request header that caused the error."
          }
        },
        "readOnly": true
      },
      "SingleResourceBody_WorkflowStepResourceV1_": {
        "properties": {
          "data": {
            "allOf": [
              {
                "$ref": "#/components/schemas/WorkflowStepResourceV1"
              }
            ],
            "description": "The returned resource, based on the request."
          },
          "errors": {
            "type": "array",
            "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.",
            "items": {
              "$ref": "#/components/schemas/ProblemDetail",
              "description": "A problem detail object is a way to convey information about an error that occurred while processing a request."
            }
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values."
          },
          "included": {
            "type": "array",
            "description": "A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).",
            "items": {}
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`."
          }
        },
        "readOnly": true
      },
      "StepCategory": {
        "description": "The category of the workflow step. Valid values are `TODO` (To do), `IN_PROGRESS` (In progress), `DONE` (Done), or `WONT_DO` (Won't do). The category determines the general stage of work items in this step.",
        "enum": [
          "TODO",
          "IN_PROGRESS",
          "DONE",
          "WONT_DO"
        ]
      },
      "StepType": {
        "description": "The high-level classification of the workflow step. Determines the default color shown in the Atono application if no custom color is set, and helps identify the most appropriate step to move items to when a step is deleted or the workflow is reset.",
        "enum": [
          "TODO",
          "DESIGN",
          "DEV",
          "TEST",
          "REVIEW",
          "DONE",
          "WONTDO",
          "REPORTED",
          "INFO_REQUIRED",
          "CUSTOM"
        ]
      },
      "WorkflowStepResourceV1": {
        "description": "A workflow step represents a stage in the team's workflow process. Stories and bugs move through these steps as they progress from creation to completion. Each step has a category (To do, In progress, Done, or Won't do) and can be configured to accept stories, bugs, or both.",
        "properties": {
          "type": {
            "type": "string",
            "default": "workflow_step",
            "description": "Identifies the type of resource.",
            "pattern": "workflow_step",
            "defaultValue": "workflow_step"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The unique identifier for the resource, typically a UUID."
          },
          "attributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/WorkflowStepResourceV1.Attributes"
              }
            ],
            "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps."
          }
        },
        "readOnly": true
      },
      "WorkflowStepResourceV1.Attributes": {
        "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the workflow step."
          },
          "category": {
            "allOf": [
              {
                "$ref": "#/components/schemas/StepCategory"
              }
            ],
            "description": "The category of the workflow step. Valid values are `TODO` (To do), `IN_PROGRESS` (In progress), `DONE` (Done), or `WONT_DO` (Won't do). The category determines the general stage of work items in this step."
          },
          "position": {
            "type": "integer",
            "format": "int32",
            "description": "The position of the workflow step within its category. Steps are ordered by category first, then by position within the category."
          },
          "color": {
            "type": "string",
            "description": "The color associated with the workflow step, typically used for visual representation in the Atono application."
          },
          "stepType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/StepType"
              }
            ],
            "description": "The high-level classification of the workflow step. Determines the default color shown in the Atono application if no custom color is set, and helps identify the most appropriate step to move items to when a step is deleted or the workflow is reset."
          },
          "forStory": {
            "type": "boolean",
            "description": "Indicates whether stories can be assigned to this workflow step (`true`) or not (`false`)."
          },
          "forBug": {
            "type": "boolean",
            "description": "Indicates whether bugs can be assigned to this workflow step (`true`) or not (`false`)."
          },
          "allowNewItems": {
            "type": "boolean",
            "description": "Indicates whether new backlog items can be created directly in this workflow step (`true`) or not (`false`)."
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "name": "X-API-KEY",
        "in": "header"
      }
    }
  }
}
```