Get a step of a pipeline

GET

/repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}

Retrieve a given step of a pipeline.

Authorizations

• oauth2
  pipeline
• basic
• api_key

Parameters

Path Parameters

workspace

required

string

This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example {workspace UUID}.

repo_slug

required

string

The repository.

pipeline_uuid

required

string

The UUID of the pipeline.

step_uuid

required

string

The UUID of the step.

Responses

200

The step.

Media type application/json

object

type

required

string

uuid

The UUID identifying the step.

string

started_on

The timestamp when the step execution was started. This is not set when the step hasn’t executed yet.

string format: date-time

completed_on

The timestamp when the step execution was completed. This is not set if the step is still in progress.

string format: date-time

state

object

type

required

string

image

Pipeline Image

The definition of a Docker image that can be used for a Bitbucket Pipelines step execution context.

object

name

The name of the image. If the image is hosted on DockerHub the short name can be used, otherwise the fully qualified name is required here.

string

username

The username needed to authenticate with the Docker registry. Only required when using a private Docker image.

string

password

The password needed to authenticate with the Docker registry. Only required when using a private Docker image.

string

email

The email needed to authenticate with the Docker registry. Only required when using a private Docker image.

string

setup_commands

The list of commands that are executed as part of the setup phase of the build. These commands are executed outside the build container.

Array<object>

Pipeline Command

An executable pipeline command.

object

name

The name of the command.

string

command

The executable command.

string

script_commands

The list of build commands. These commands are executed in the build container.

Array<object>

Pipeline Command

An executable pipeline command.

object

name

The name of the command.

string

command

The executable command.

string

Example ^generated

{
  "type": "example",
  "uuid": "example",
  "started_on": "2026-04-15T12:00:00Z",
  "completed_on": "2026-04-15T12:00:00Z",
  "state": {
    "type": "example"
  },
  "image": {
    "name": "example",
    "username": "example",
    "password": "example",
    "email": "example"
  },
  "setup_commands": [
    {
      "name": "example",
      "command": "example"
    }
  ],
  "script_commands": [
    {
      "name": "example",
      "command": "example"
    }
  ]
}

404

No account, repository, pipeline or step with the UUID provided exists for the pipeline with the UUID provided.

Media type application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}