Forums

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

With the Bitbucket API, the endpoint /user/workspaces returns a different type than declared

Markus
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
February 25, 2026

Hello,

I am using the OpenAPI specification that is found at [1].

Unfortunately, the specification has an error: the property components.schemas.workspace_access.properties.administrator is
declared as string in the OpenAPI spec, but /user/workspaces responses return
a boolean.

This can be verified with the following curl command:

curl -sS \
-u "${BITBUCKET_EMAIL}:${BITBUCKET_TOKEN}" \
"https://api.bitbucket.org/2.0/user/workspaces" \
| jq '.values[0] | { administrator, administrator_type: (.administrator | type) }'

{
"administrator": false,
"administrator_type": "boolean"
}

 

It would be nice if this would be corrected in a future version of the OpenAPI specification.

Kind regards!

P.S.: there should be a simpler way to report this than going through the steps at [2], just to be forwarded to this community forum...

[1] https://developer.atlassian.com/cloud/bitbucket/rest/

[2] https://support.atlassian.com/contact/

1 answer

0 votes
Syahrul
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 1, 2026

Hey @Markus Rothe 

Welcome to the community.

Thank you for reporting this issue. I was able to reproduce it and has proceeded to raise a bug report that you can keep track at

https://jira.atlassian.com/browse/BCLOUD-24027

I hope this helps.

Regards,
Syahrul

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
TAGS
AUG Leaders

Atlassian Community Events