---
title: "Get user permission on a workspace"
method: GET
path: "/user/workspaces/{workspace}/permission"
tags: ["Workspaces"]
---

# Get user permission on a workspace

`GET /user/workspaces/{workspace}/permission`

Returns the caller's effective role; as in, the highest level of privilege
the caller has for the workspace.
If the calling user is a member of multiple groups with distinct roles, only the
highest level is returned.

Permissions can be:

* `owner`
* `create-project`
* `collaborator` (deprecated; see this
[deprecation announcement](/cloud/bitbucket/deprecation-notice-collaborator-role/) for more details)
* `member`

## Response `200`

The user that is part of a workspace.

- WorkspaceMembership — A Bitbucket workspace membership. Links a user to a workspace.
  - `type` string, required
  - `links` object
    - `self` object — A link to a resource related to this object.
      - `href` string, uri
      - `name` string
  - `user` Account — An account object.
    - `type` string, required
    - `links` AccountLinks — Links related to an Account.
      - `avatar` Link — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
    - `created_on` string, date-time
    - `display_name` string
    - `uuid` string
  - `workspace` Workspace — A Bitbucket workspace. Workspaces are used to organize repositories.
    - `type` string, required
    - `links` object
      - `avatar` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `html` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `members` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `owners` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `projects` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `repositories` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `snippets` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
      - `self` object — A link to a resource related to this object.
        - `href` string, uri
        - `name` string
    - `uuid` string — The workspace's immutable id.
    - `name` string — The name of the workspace.
    - `slug` string — The short label that identifies this workspace.
    - `is_private` boolean — Indicates whether the workspace is publicly accessible, or whether it is private to the members and consequently only visible to members.
    - `is_personal` boolean — Indicates whether the workspace belongs to an individual user.
    - `is_privacy_enforced` boolean — Indicates whether the workspace enforces private content, or whether it allows public content.
    - `forking_mode` 'allow_forks' | 'internal_only' — Controls the rules for forking repositories within this workspace. * **allow_forks**: unrestricted forking * **internal_only**: prevents forking of private repositories outside the workspace or to public repositories
    - `created_on` string, date-time
    - `updated_on` string, date-time

## Other responses

- `401` — The request wasn't authenticated.
- `403` — The requesting user does not have access to the workspace.

---

[API](https://skmtc.net/atlassian/apis/bitbucket-api.md) · [All operations](https://skmtc.net/atlassian/apis/bitbucket-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/bitbucket-api/versions/8c7911c0a910/schema)