How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Bitbucket Pipelines Repositories API

A Git repository is a virtual storage of your project. Itallows you to save versions of your code, which you can accesswhen needed. The repo resource allows you to access public repos,or repos that belong to a specific workspace.

Bitbucket Pipelines Repositories API is one of 23 APIs that Bitbucket Pipelines publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Repositories. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 30 operations across 17 paths, and defines 36 schemas. It is described by OpenAPI 2.0, at version 2.0.

Requests are made against the base URL https://api.bitbucket.org/2.0.

30 operations 17 paths 36 schemas 4 DELETE17 GET4 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2.0
Base URL
https://api.bitbucket.org/2.0
Authentication
basic, OAuth 2.0, API Key
Terms of Service
Resource Areas
1

Authentication & Security 3

Bitbucket Pipelines Repositories API declares 3 security schemes for authenticating requests. It defines a basic scheme (basic). It supports OAuth 2.0 (oauth2) using the accessCode flow, exposing 26 scopes. An API key is passed in the header as Authorization (api_key).

  • basic — Basic HTTP Authentication as per [RFC-2617](https://tools.ietf.org/html/rfc2617) (Digest not supported). Note that Basic Auth is available only with username a…
  • oauth2 — OAuth 2 as per [RFC-6749](https://tools.ietf.org/html/rfc6749).
  • api_key — API Keys can be used as Basic HTTP Authentication credentials and provide a substitute for the account's actual username and password. API Keys are only availa…

Paths & Operations 30

Across 17 paths, the API surfaces 30 operations — 4 DELETE, 17 GET, 4 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Repositories 30

A Git repository is a virtual storage of your project. It allows you to save versions of your code, which you can access when needed. The repo resource allows you to access public…

GET
/repositoriesdeprecated
List public repositories
4 params → 200
GET
/repositories/{workspace}
List repositories in a workspace
4 params → 200404410
DELETE
/repositories/{workspace}/{repo_slug}
Delete a repository
3 params → 204403404
GET
/repositories/{workspace}/{repo_slug}
Get a repository
2 params → 200403404
POST
/repositories/{workspace}/{repo_slug}
Create a repository
3 params → 200400401
PUT
/repositories/{workspace}/{repo_slug}
Update a repository
3 params → 200201400401
GET
/repositories/{workspace}/{repo_slug}/filehistory/{commit}/{path}
List commits that modified a file
7 params → 200404
GET
/repositories/{workspace}/{repo_slug}/forks
List repository forks
5 params → 200
POST
/repositories/{workspace}/{repo_slug}/forks
Fork a repository
3 params → 201
GET
/repositories/{workspace}/{repo_slug}/hooks
List webhooks for a repository
2 params → 200403404
POST
/repositories/{workspace}/{repo_slug}/hooks
Create a webhook for a repository
2 params → 201403404
DELETE
/repositories/{workspace}/{repo_slug}/hooks/{uid}
Delete a webhook for a repository
3 params → 204403404
GET
/repositories/{workspace}/{repo_slug}/hooks/{uid}
Get a webhook for a repository
3 params → 200404
PUT
/repositories/{workspace}/{repo_slug}/hooks/{uid}
Update a webhook for a repository
3 params → 200403404
GET
/repositories/{workspace}/{repo_slug}/override-settings
Retrieve the inheritance state for repository settings
2 params → 200404
PUT
/repositories/{workspace}/{repo_slug}/override-settings
Set the inheritance state for repository settings
2 params → 204404
GET
/repositories/{workspace}/{repo_slug}/permissions-config/groups
List explicit group permissions for a repository
2 params → 200401403404
DELETE
/repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug}
Delete an explicit group permission for a repository
3 params → 204401403404
GET
/repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug}
Get an explicit group permission for a repository
3 params → 200401403404
PUT
/repositories/{workspace}/{repo_slug}/permissions-config/groups/{group_slug}
Update an explicit group permission for a repository
4 params → 200400401402403404
GET
/repositories/{workspace}/{repo_slug}/permissions-config/users
List explicit user permissions for a repository
2 params → 200401403404
DELETE
/repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id}
Delete an explicit user permission for a repository
3 params → 204401403404
GET
/repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id}
Get an explicit user permission for a repository
3 params → 200401403404
PUT
/repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user_id}
Update an explicit user permission for a repository
4 params → 200400401402403404
GET
/repositories/{workspace}/{repo_slug}/src
Get the root directory of the main branch
3 params → 200404
POST
/repositories/{workspace}/{repo_slug}/src
Create a commit by uploading a file
7 params → 201403404
GET
/repositories/{workspace}/{repo_slug}/src/{commit}/{path}
Get file or directory contents
8 params → 200404555
GET
/repositories/{workspace}/{repo_slug}/watchers
List repositories watchers
2 params → 200
GET
/user/permissions/repositoriesdeprecated
List repository permissions for a user
2 params → 200
GET
/user/workspaces/{workspace}/permissions/repositories
List repository permissions in a workspace for a user
3 params → 200400401403

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are paginated_accounts (6 properties), paginated_webhook_subscriptions (6 properties), paginated_repository_user_permissions (6 properties), paginated_files (6 properties). Each schema is shown below with its type and property counts.

repository_user_permission
object
A user's direct permission for a given repository.
5 properties 1 required
project
repository_inheritance_state
object
A json object representing the repository's inheritance state values
2 properties 1 required
base_commit
object
object
Base type for most resource objects. It defines the common type element that identifies an object's type. It also identifies the element as Swagger's discrimin…
1 property 1 required
commit_file
object
A file object, representing a file at a commit in a repository
5 properties 1 required
paginated_webhook_subscriptions
object
A paginated list of webhook subscriptions
6 properties
paginated_repository_user_permissions
object
A paginated list of repository user permissions.
6 properties
group
account
branch
paginated_files
object
A paginated list of commitfile objects.
6 properties
participant
team_links
ref
object
A ref object, representing a branch or tag in a repository.
4 properties 1 required
bitbucket.apps.permissions.serializers.RepoPermissionUpdateSchema
object
1 property 1 required
user
repository_group_permission
object
A group's permission for a given repository.
5 properties 1 required
author
error
object
Base type for most resource objects. It defines the common type element that identifies an object's type. It also identifies the element as Swagger's discrimin…
2 properties 1 required
paginated_repository_permissions
object
A paginated list of repository permissions.
6 properties
paginated_repositories
object
A paginated list of repositories.
6 properties
paginated_treeentries
object
A paginated list of commitfile and/or commitdirectory objects.
6 properties
committer
account_links
object
Links related to an Account.
1 property
treeentry
object
Base type for most resource objects. It defines the common type element that identifies an object's type. It also identifies the element as Swagger's discrimin…
3 properties 1 required
repository_permission
object
A user's permission for a given repository.
4 properties 1 required
paginated_accounts
object
A paginated list of accounts.
6 properties
webhook_subscription
user_links
commit
repository
link
object
A link to a resource related to this object.
2 properties
team
workspace
paginated_repository_group_permissions
object
A paginated list of repository group permissions.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bitbucket-pipelines-repositories-api-openapi.yml Raw ↑

Other APIs Bitbucket Pipelines publishes across the network.

Bitbucket Pipelines Addon API
Bitbucket Pipelines Branch restrictions API
Bitbucket Pipelines Branching model API
Bitbucket Pipelines Commit statuses API
Bitbucket Pipelines Commits API
Bitbucket Pipelines Deployments API
Bitbucket Pipelines Downloads API
Bitbucket Pipelines GPG API
Bitbucket Pipelines Issue tracker API
Bitbucket Pipelines Pipelines API
Bitbucket Pipelines Projects API
Bitbucket Pipelines properties API
Where this information came from

This is an independent, third-party profile of Bitbucket Pipelines Repositories API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.