Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Open Api Document plugin in Confluence using SSH repo for source

Hi all,

in my corporate Confluence I want to use OpenApi Documentation plugin

In the configurations I put:


GitHub Access Token: put the BitBucket access token for the repo from the URL

But I have:

Failed to load API definition.

I tried with username/password but the same result.


Is it possible to do that to access BitBucket resource using accessToken and to create a reference in the COnfluence's Open Api Documentation Plugin?


2 answers

Hi Dinio & Luca,

We are the creators of the Open API Documentation for Confluence plugin (there are a few other Swagger plugins in the Marketplace, so it may be that you are using ours or one of our competitors).

Dinio - Bitbucket Server does have a few known issues because it doesn't properly deal with CORS requests (e.g. by default it doesn't handle OPTIONS requests).

CORS is a standard browser security feature that prevents Javascript code running in one domain (e.g. your Confluence server) from accessing resources in another domain (e.g. your Bitbucket server), without first getting permissions. It gets these permissions through a series of "Access-Control-*" headers, in both the request (from the browser displaying your Confluence page) and the response (from your Bitbucket server that has your YAML/JSON file).

In the case where your Bitbucket repository is not publicly accessible (i.e. requires a username + password), your browser must first perform what is called a "preflight" OPTIONS request to get the right permissions, and Bitbucket Server doesn't accept OPTIONS requests by default.  There are workarounds that involve using a proxy in front of your Bitbucket Server to deal with this.


Luca - GitLab is supported, and we have some details in our documentation on how to configure the macro.


I hope this information is useful.


Kind regards,


0 votes
Luca Saba I'm New Here Aug 20, 2021

I'm having the same issue. I'm using GitLab and a project token.

By enabling the developer toolbar I can see that the request doesn't contain the required header (PRIVATE-TOKEN in my case).

Since this information is not provided, Gitlab correctly returns an HTTP 404 error message

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Apps & Integrations

🍂📹 Apptoberfest demo contest roundup: vote for your favorite demos!

Hi Community! The submissions are in (and listed below) for the 🍻🍂Apptoberfest🍂🍻 Demo Competition and it’s time for you to place your votes for the best: Analytics & reporting app demo ...

241 views 6 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you