Addon
Branch restrictions
Branching model
Commit statuses
Commits
Deployments
Downloads
Issue tracker
Pipelines
Projects
Pullrequests
Refs
Reports
Repositories
Snippets
Source
Ssh
Teams
Users
Webhooks
Workspaces
Other operations

Rate this page:

Users

The users resource allows you to access public information associated with a user account. Most resources in the users endpoint have been deprecated in favor of workspaces.

List workspace repositories

Deprecated

GET /2.0/teams/{workspace}/repositories

All repositories in the given workspace. This includes any private repositories the calling user has access to.

This endpoint has been removed. You should use the repository list endpoint instead. For more information, see the deprecation announcement.

OAuth scopes required
repository

Request

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}.

Example

1
2
3
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/teams/{workspace}/repositories' \
  --header 'Authorization: Bearer <access_token>'

Responses

Unexpected error.

Content typeValue
application/json

Error

Get current user

GET /2.0/user

Returns the currently logged in user.

OAuth scopes required
account

Request

There are no parameters for this request.

Example

1
2
3
4
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/user' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

The current user.

Content typeValue
application/json

allOf [allOf [object, Account], User]

List email addresses for current user

GET /2.0/user/emails

Returns all the authenticated user's email addresses. Both confirmed and unconfirmed.

OAuth scopes required
email

Request

There are no parameters for this request.

Example

1
2
3
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/user/emails' \
  --header 'Authorization: Bearer <access_token>'

Responses

Unexpected error.

Content typeValue
application/json

Error

Get an email address for current user

GET /2.0/user/emails/{email}

Returns details about a specific one of the authenticated user's email addresses. Details describe whether the address has been confirmed by the user and whether it is the user's primary address or not.

OAuth scopes required
email

Request

Path parameters
email Required

string

Email address of the user.

Example

1
2
3
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/user/emails/{email}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Unexpected error.

Content typeValue
application/json

Error

Get a user

GET /2.0/users/{selected_user}

Gets the public information associated with a user account.

If the user's profile is private, location, website and created_on elements are omitted.

Note that the user object returned by this operation is changing significantly, due to privacy changes. See the announcement for details.

OAuth scopes required
NONE

Request

Path parameters
selected_user Required

string

This can either be the UUID of the account, surrounded by curly-braces, for example: {account UUID}, OR an Atlassian Account ID.

Example

1
2
3
4
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/users/{selected_user}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

The user object

Content typeValue
application/json

allOf [allOf [object, Account], User]

List team users

Deprecated

GET /2.0/users/{username}/members

This endpoint has been removed. You should use the workspaces endpoint instead. For more information, see this post.

OAuth scopes required
account

Request

Path parameters
username Required

string

This can either be the username or the UUID of the account, surrounded by curly-braces, for example: {account UUID}. An account is either a team or user.

Example

1
2
3
4
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/users/{username}/members' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

All members

Content typeValue
application/json

allOf [allOf [object, Account], User]

List workspace repositories

Deprecated

GET /2.0/users/{workspace}/repositories

All repositories in the given workspace. This includes any private repositories the calling user has access to.

This endpoint has been removed. You should use the repository list endpoint instead. For more information, see the deprecation announcement.

OAuth scopes required
repository

Request

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}.

Example

1
2
3
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/users/{workspace}/repositories' \
  --header 'Authorization: Bearer <access_token>'

Responses

Unexpected error.

Content typeValue
application/json

Error

Rate this page: