---
title: "Find steps"
method: GET
path: "/search-steps"
tags: ["configuration"]
---

# Find steps

`GET /search-steps`

Find steps for building workflows or step bundles in a Bitrise YML config file, based on name, description, tags or maintainers.Returns only the latest, non-deprecated versions.

## Query parameters

- `query` string, required
- `categories` string[]
- `maintainers` string[]

## Response `200`

Step data returned

- ServiceDtoStepResponse[]
  - `description` string
  - `id` string — Unique identifier for the step
  - `inputs` ServiceDtoStepInputOutputResponse[]
    - `default_value` string
    - `description` string
    - `is_required` boolean
    - `is_sensitive` boolean
    - `name` string
    - `summary` string
    - `title` string
    - `value_options` string[] — List of allowed values for the parameter (if restricted)
  - `is_deprecated` boolean
  - `is_latest` boolean
  - `latest_version_number` string
  - `maintainer` 'bitrise' | 'verified' | 'community' — Maintainer of the step
  - `outputs` ServiceDtoStepInputOutputResponse[]
    - `default_value` string
    - `description` string
    - `is_required` boolean
    - `is_sensitive` boolean
    - `name` string
    - `summary` string
    - `title` string
    - `value_options` string[] — List of allowed values for the parameter (if restricted)
  - `step_ref` string — Composite Version Specification of the step, see https://docs.bitrise.io/en/bitrise-ci/references/steps-reference/step-reference-id-format.html
  - `summary` string
  - `title` string
  - `version` string — Version number of the step

## Other responses

- `400` — Missing or invalid parameters

---

[API](https://skmtc.net/bitrise/apis/bitrise-api.md) · [All operations](https://skmtc.net/bitrise/apis/bitrise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrise/bitrise-api/versions/89468e4a014b/schema)