Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Published pipeline configuration schema is not complete

Casper Rademaker
May 30, 2026

Hello there,

In our pipelines we validate `bitbucket-pipelines.yml` against the official schema published at api.bitbucket.org/schemas/pipelines-configuration

However, this simple example below which imports and runs a pipeline from another repo which exports it fails on validation

```

options:
  max-time: 3 

clone:
  depth: 1 

pipelines:
  pull-requests:
    "**":
      import: bitbucket-pipeline-templates:main:generic-pr-pipeline
```

Due to:

```
jsonschema.exceptions.ValidationError: {'import': 'bitbucket-pipeline-templates:main:generic-pr-pipeline'} is not of type 'array'
Failed validating 'type' in schema['properties']['pipelines']['properties']['pull-requests']['additionalProperties']:
{'description': 'List of steps, stages and parallel groups of the '
'pipeline.',
'items': {'oneOf': [{'$ref': '#/components/schemas/step_item'},
{'$ref': '#/components/schemas/parallel_item'},
{'$ref': '#/components/schemas/stage_item'},
{'$ref': '#/components/schemas/final_item'}]},
'minItems': 1,
'title': 'Pipeline Items',
'type': 'array'}
On instance['pipelines']['pull-requests']['**']:
{'import': 'bitbucket-pipeline-templates:main:generic-pr-pipeline'}
```

Although this type of import is perfectly valid and works without issues, and is also documented at Share Pipelines Configurations | Bitbucket Cloud | Atlassian Support
It seems the published schema is not complete. Can this be fixed?

Thank you in advance,

Best regards,

Casper Rademaker

2 answers

0 votes
Mark C
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
July 2, 2026

Hi @Casper Rademaker

Thank you for reaching out to the community.

Our internal team confirmed that this is now added to the list.

Could you please confirm that you can see it now?

Regards,
Mark C

0 votes
Kristian Walker _Adaptavist_
Community Champion
June 23, 2026

Hi Casper,

I have clicked the Request Assistance button so that Atlassian support can look into this issue for you.

I hope this helps.

Regards,

Kristian

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin Site Admin
TAGS
AUG Leaders

Atlassian Community Events