Bitbucket API — Pipelines. 68 operations. Lead operation: List variables for an environment. Self-contained Naftiko capability covering one Bitbucket business surface.
naftiko: 1.0.0-alpha2
info:
label: Bitbucket API — Pipelines
description: 'Bitbucket API — Pipelines. 68 operations. Lead operation: List variables for an environment. Self-contained
Naftiko capability covering one Bitbucket business surface.'
tags:
- Bitbucket
- Pipelines
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
BITBUCKET_API_KEY: BITBUCKET_API_KEY
capability:
consumes:
- type: http
namespace: cloud-rest-pipelines
baseUri: https://api.bitbucket.org/2.0
description: Bitbucket API — Pipelines business capability. Self-contained, no shared references.
resources:
- name: repositories-workspace-repo_slug-deployments_config-environments-environment_uui
path: /repositories/{workspace}/{repo_slug}/deployments_config/environments/{environment_uuid}/variables
operations:
- name: getdeploymentvariables
method: GET
description: List variables for an environment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: environment_uuid
in: path
type: string
description: The environment.
required: true
- name: createdeploymentvariable
method: POST
description: Create a variable for an environment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: environment_uuid
in: path
type: string
description: The environment.
required: true
- name: _body
in: body
type: string
description: The variable to create
required: true
- name: repositories-workspace-repo_slug-deployments_config-environments-environment_uui
path: /repositories/{workspace}/{repo_slug}/deployments_config/environments/{environment_uuid}/variables/{variable_uuid}
operations:
- name: updatedeploymentvariable
method: PUT
description: Update a variable for an environment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: environment_uuid
in: path
type: string
description: The environment.
required: true
- name: variable_uuid
in: path
type: string
description: The UUID of the variable to update.
required: true
- name: _body
in: body
type: string
description: The updated deployment variable.
required: true
- name: deletedeploymentvariable
method: DELETE
description: Delete a variable for an environment
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: environment_uuid
in: path
type: string
description: The environment.
required: true
- name: variable_uuid
in: path
type: string
description: The UUID of the variable to delete.
required: true
- name: repositories-workspace-repo_slug-pipelines
path: /repositories/{workspace}/{repo_slug}/pipelines
operations:
- name: getpipelinesforrepository
method: GET
description: List pipelines
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: creator.uuid
in: query
type: string
description: The UUID of the creator of the pipeline to filter by.
- name: target.ref_type
in: query
type: string
description: The type of the reference to filter by.
- name: target.ref_name
in: query
type: string
description: The reference name to filter by.
- name: target.branch
in: query
type: string
description: The name of the branch to filter by.
- name: target.commit.hash
in: query
type: string
description: The revision to filter by.
- name: target.selector.pattern
in: query
type: string
description: The pipeline pattern to filter by.
- name: target.selector.type
in: query
type: string
description: The type of pipeline to filter by.
- name: created_on
in: query
type: string
description: The creation date to filter by.
- name: trigger_type
in: query
type: string
description: The trigger type to filter by.
- name: status
in: query
type: string
description: The pipeline status to filter by.
- name: sort
in: query
type: string
description: The attribute name to sort on.
- name: page
in: query
type: integer
description: The page number of elements to retrieve.
- name: pagelen
in: query
type: integer
description: The maximum number of results to return.
- name: createpipelineforrepository
method: POST
description: Run a pipeline
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: _body
in: body
type: string
description: The pipeline to initiate.
required: true
- name: repositories-workspace-repo_slug-pipelines-config-caches
path: /repositories/{workspace}/{repo_slug}/pipelines-config/caches
operations:
- name: getrepositorypipelinecaches
method: GET
description: List caches
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: The account.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: deleterepositorypipelinecaches
method: DELETE
description: Delete caches
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: The account.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: name
in: query
type: string
description: The cache name.
required: true
- name: repositories-workspace-repo_slug-pipelines-config-caches-cache_uuid
path: /repositories/{workspace}/{repo_slug}/pipelines-config/caches/{cache_uuid}
operations:
- name: deleterepositorypipelinecache
method: DELETE
description: Delete a cache
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: The account.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: cache_uuid
in: path
type: string
description: The UUID of the cache to delete.
required: true
- name: repositories-workspace-repo_slug-pipelines-config-caches-cache_uuid-content-uri
path: /repositories/{workspace}/{repo_slug}/pipelines-config/caches/{cache_uuid}/content-uri
operations:
- name: getrepositorypipelinecachecontenturi
method: GET
description: Get cache content URI
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: The account.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: cache_uuid
in: path
type: string
description: The UUID of the cache.
required: true
- name: repositories-workspace-repo_slug-pipelines-config-runners
path: /repositories/{workspace}/{repo_slug}/pipelines-config/runners
operations:
- name: getrepositoryrunners
method: GET
description: Get repository runners
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: createrepositoryrunner
method: POST
description: Create repository runner
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: repositories-workspace-repo_slug-pipelines-config-runners-runner_uuid
path: /repositories/{workspace}/{repo_slug}/pipelines-config/runners/{runner_uuid}
operations:
- name: getrepositoryrunner
method: GET
description: Get repository runner
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: runner_uuid
in: path
type: string
description: The runner uuid.
required: true
- name: updaterepositoryrunner
method: PUT
description: Update repository runner
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: runner_uuid
in: path
type: string
description: The runner uuid.
required: true
- name: deleterepositoryrunner
method: DELETE
description: Delete repository runner
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: runner_uuid
in: path
type: string
description: The runner uuid.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}
operations:
- name: getpipelineforrepository
method: GET
description: Get a pipeline
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The pipeline UUID.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps
operations:
- name: getpipelinestepsforrepository
method: GET
description: List steps for a pipeline
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}
operations:
- name: getpipelinestepforrepository
method: GET
description: Get a step of a pipeline
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid-log
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}/log
operations:
- name: getpipelinesteplogforrepository
method: GET
description: Get log file for a step
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid-logs-lo
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}/logs/{log_uuid}
operations:
- name: getpipelinecontainerlog
method: GET
description: Get the logs for the build container or a service container for a given step of a pipeline.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: log_uuid
in: path
type: string
description: For the main build container specify the step UUID; for a service container specify the service container
UUID
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid-test_re
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}/test_reports
operations:
- name: getpipelinetestreports
method: GET
description: Get a summary of test reports for a given step of a pipeline.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid-test_re
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}/test_reports/test_cases
operations:
- name: getpipelinetestreporttestcases
method: GET
description: Get test cases for a given step of a pipeline.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-steps-step_uuid-test_re
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/steps/{step_uuid}/test_reports/test_cases/{test_case_uuid}/test_case_reasons
operations:
- name: getpipelinetestreporttestcasereasons
method: GET
description: Get test case reasons (output) for a given test case in a step of a pipeline.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: step_uuid
in: path
type: string
description: The UUID of the step.
required: true
- name: test_case_uuid
in: path
type: string
description: The UUID of the test case.
required: true
- name: repositories-workspace-repo_slug-pipelines-pipeline_uuid-stopPipeline
path: /repositories/{workspace}/{repo_slug}/pipelines/{pipeline_uuid}/stopPipeline
operations:
- name: stoppipeline
method: POST
description: Stop a pipeline
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: pipeline_uuid
in: path
type: string
description: The UUID of the pipeline.
required: true
- name: repositories-workspace-repo_slug-pipelines_config
path: /repositories/{workspace}/{repo_slug}/pipelines_config
operations:
- name: getrepositorypipelineconfig
method: GET
description: Get configuration
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: The account.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: updaterepositorypipelineconfig
method: PUT
description: Update configuration
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: _body
in: body
type: string
description: The updated repository pipelines configuration.
required: true
- name: repositories-workspace-repo_slug-pipelines_config-build_number
path: /repositories/{workspace}/{repo_slug}/pipelines_config/build_number
operations:
- name: updaterepositorybuildnumber
method: PUT
description: Update the next build number
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: _body
in: body
type: string
description: The build number to update.
required: true
- name: repositories-workspace-repo_slug-pipelines_config-schedules
path: /repositories/{workspace}/{repo_slug}/pipelines_config/schedules
operations:
- name: createrepositorypipelineschedule
method: POST
description: Create a schedule
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: _body
in: body
type: string
description: The schedule to create.
required: true
- name: getrepositorypipelineschedules
method: GET
description: List schedules
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: repositories-workspace-repo_slug-pipelines_config-schedules-schedule_uuid
path: /repositories/{workspace}/{repo_slug}/pipelines_config/schedules/{schedule_uuid}
operations:
- name: getrepositorypipelineschedule
method: GET
description: Get a schedule
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: schedule_uuid
in: path
type: string
description: The uuid of the schedule.
required: true
- name: updaterepositorypipelineschedule
method: PUT
description: Update a schedule
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: schedule_uuid
in: path
type: string
description: The uuid of the schedule.
required: true
- name: _body
in: body
type: string
description: The schedule to update.
required: true
- name: deleterepositorypipelineschedule
method: DELETE
description: Delete a schedule
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: repo_slug
in: path
type: string
description: The repository.
required: true
- name: schedule_uuid
in: path
type: string
description: The uuid of the schedule.
required: true
- name: repositories-workspace-repo_slug-pipelines_config-schedules-schedule_uuid-execut
path: /repositories/{workspace}/{repo_slug}/pipelines_config/schedules/{schedule_uuid}/executions
operations:
- name: getrepositorypipelinescheduleexecutions
method: GET
description: List executions of a schedule
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: workspace
in: path
type: string
description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example
`{workspace UUID}`.
required: true
- name: rep
# --- truncated at 32 KB (120 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/capabilities/cloud-rest-pipelines.yaml