Use Bitbucket Cloud to read repositories, branches, commits, files, and diffs; create or delete branches; and manage pull requests and comments. Pipeline actions list runs and steps, start or stop runs, and retrieve step logs.
Connect a Bitbucket account through OAuth. Triggers can start workflows on pushes, repository changes, build status updates, and pull request events; Sim manages their webhooks. For example, a workflow can read a failed pipeline's logs or review a newly opened pull request.
Sim requests these scopes when someone connects a Bitbucket account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.
Setting Value Redirect URI <NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/bitbucketEnvironment variables BITBUCKET_CLIENT_ID, BITBUCKET_CLIENT_SECRET
Scope Description accountView your Bitbucket account and workspace memberships repositoryView repositories and source code repository:writePush to repositories and create or delete branches pullrequestView and comment on pull requests pullrequest:writeCreate, update, approve, decline, and merge pull requests pipelineView pipelines, steps, and logs pipeline:writeRun and stop pipelines webhookManage repository webhooks
Connect Bitbucket Cloud to inspect repositories and source, collaborate on pull requests, diagnose or control pipelines, and start workflows from repository and pull request events. OAuth is used for actions and automatic webhook management.
List Bitbucket Cloud workspaces available to the authenticated account
Inputs and outputsParameter Type Required Description sortstring No Workspace sort field; Bitbucket currently supports slug administratorboolean No Filter by whether the caller is a workspace administrator nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Workspace access records ↳ type string Bitbucket workspace-access object type ↳ slug string Workspace slug ↳ uuid string Workspace UUID ↳ administrator boolean Whether the caller administers the workspace ↳ selfUrl string Workspace API URL ↳ avatarUrl string Workspace avatar URL
List repositories in a Bitbucket Cloud workspace
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID rolestring No Caller role filter: admin, contributor, member, or owner qstring No Bitbucket filtering expression sortstring No Bitbucket sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Repositories ↳ type string Bitbucket repository object type ↳ uuid string Repository UUID ↳ slug string Repository slug ↳ name string Repository name ↳ fullName string Workspace and repository full name ↳ description string Repository description ↳ isPrivate boolean Whether the repository is private ↳ scm string Source control system ↳ language string Primary repository language ↳ size number Repository size in bytes ↳ createdOn string Repository creation timestamp ↳ updatedOn string Repository update timestamp ↳ mainBranch string Main branch name ↳ owner object Repository owner ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ project object Containing Bitbucket project ↳ uuid string Project UUID ↳ key string Project key ↳ name string Project name ↳ selfUrl string Repository API URL ↳ htmlUrl string Repository web URL
Get a Bitbucket Cloud repository
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID
Parameter Type Description repositoryobject Repository details ↳ type string Bitbucket repository object type ↳ uuid string Repository UUID ↳ slug string Repository slug ↳ name string Repository name ↳ fullName string Workspace and repository full name ↳ description string Repository description ↳ isPrivate boolean Whether the repository is private ↳ scm string Source control system ↳ language string Primary repository language ↳ size number Repository size in bytes ↳ createdOn string Repository creation timestamp ↳ updatedOn string Repository update timestamp ↳ mainBranch string Main branch name ↳ owner object Repository owner ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ project object Containing Bitbucket project ↳ uuid string Project UUID ↳ key string Project key ↳ name string Project name ↳ selfUrl string Repository API URL ↳ htmlUrl string Repository web URL
List branches in a Bitbucket Cloud repository
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID qstring No Bitbucket branch filtering expression sortstring No Bitbucket branch sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Branches ↳ type string Bitbucket branch object type ↳ name string Branch name ↳ target object Commit targeted by the branch ↳ type string Bitbucket commit object type ↳ hash string Commit hash ↳ date string Commit timestamp ↳ message string Full commit message ↳ summary string Raw commit summary ↳ authorRaw string Raw author value stored by Git ↳ author object Matched Bitbucket account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ committerRaw string Raw committer value stored by Git ↳ committer object Matched Bitbucket committer account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ parents array Parent commits ↳ hash string Parent commit hash ↳ selfUrl string Commit API URL ↳ htmlUrl string Commit web URL ↳ mergeStrategies array Merge strategies available for the branch ↳ defaultMergeStrategy string Default merge strategy ↳ selfUrl string Branch API URL ↳ htmlUrl string Branch web URL
Create a branch at a commit hash or existing ref
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID namestring Yes New branch name without refs/heads prefix targetstring Yes Full commit hash or existing ref to target
Parameter Type Description branchobject Created branch ↳ type string Bitbucket branch object type ↳ name string Branch name ↳ target object Commit targeted by the branch ↳ type string Bitbucket commit object type ↳ hash string Commit hash ↳ date string Commit timestamp ↳ message string Full commit message ↳ summary string Raw commit summary ↳ authorRaw string Raw author value stored by Git ↳ author object Matched Bitbucket account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ committerRaw string Raw committer value stored by Git ↳ committer object Matched Bitbucket committer account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ parents array Parent commits ↳ hash string Parent commit hash ↳ selfUrl string Commit API URL ↳ htmlUrl string Commit web URL ↳ mergeStrategies array Merge strategies available for the branch ↳ defaultMergeStrategy string Default merge strategy ↳ selfUrl string Branch API URL ↳ htmlUrl string Branch web URL
Delete a branch from a Bitbucket Cloud repository
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID namestring Yes Branch name to delete
Parameter Type Description deletedboolean Whether the branch was deleted
List repository commits in reverse chronological order
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Commits ↳ type string Bitbucket commit object type ↳ hash string Commit hash ↳ date string Commit timestamp ↳ message string Full commit message ↳ summary string Raw commit summary ↳ authorRaw string Raw author value stored by Git ↳ author object Matched Bitbucket account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ committerRaw string Raw committer value stored by Git ↳ committer object Matched Bitbucket committer account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ parents array Parent commits ↳ hash string Parent commit hash ↳ selfUrl string Commit API URL ↳ htmlUrl string Commit web URL
Get a repository commit by its full SHA-1
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID commitstring Yes Full 40-character commit SHA-1
Parameter Type Description commitobject Commit details ↳ type string Bitbucket commit object type ↳ hash string Commit hash ↳ date string Commit timestamp ↳ message string Full commit message ↳ summary string Raw commit summary ↳ authorRaw string Raw author value stored by Git ↳ author object Matched Bitbucket account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ committerRaw string Raw committer value stored by Git ↳ committer object Matched Bitbucket committer account, when available ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ parents array Parent commits ↳ hash string Parent commit hash ↳ selfUrl string Commit API URL ↳ htmlUrl string Commit web URL
List one shallow repository directory at a full commit SHA-1
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID commitstring Yes Full 40-character commit SHA-1 pathstring No Repository-relative directory path; omit for the root qstring No Bitbucket tree-entry filtering expression sortstring No Bitbucket tree-entry sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Directory entries ↳ type string Entry type, such as commit_file or commit_directory ↳ path string Repository-relative path ↳ commitHash string Resolved commit hash ↳ size number File size in bytes when the entry is a file ↳ attributes array File attributes when the entry is a file ↳ isBinary boolean Whether file attributes include the binary marker ↳ selfUrl string Source API URL ↳ metadataUrl string Source metadata API URL
Inspect file size and attributes at a full repository commit SHA-1
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID commitstring Yes Full 40-character commit SHA-1 pathstring Yes Repository-relative file path
Parameter Type Description fileobject File metadata ↳ type string Entry type (commit_file) ↳ path string Repository-relative path ↳ commitHash string Resolved commit hash ↳ escapedPath string Escaped display path ↳ size number File size in bytes ↳ attributes array File attributes reported by Bitbucket ↳ isBinary boolean Whether the documented attributes include the binary marker
Read bounded UTF-8 text from a file at a full repository commit SHA-1
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID commitstring Yes Full 40-character commit SHA-1 pathstring Yes Repository-relative file path maxCharactersnumber No Maximum text characters to return (1-500000)
Parameter Type Description contentstring Bounded UTF-8 file text; null for binary content binaryboolean Whether documented metadata identifies binary content; null when unknown truncatedboolean Whether later content was omitted; null when binary size is unknown returnedBytesnumber Provider bytes read for the returned file fullBytesnumber Full file byte size when reported contentTypestring Response MIME type
List pull requests in a Bitbucket Cloud repository
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID statestring No State filter: OPEN, MERGED, DECLINED, or SUPERSEDED qstring No Bitbucket pull request filtering expression sortstring No Bitbucket pull request sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Pull requests ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Get a pull request by repository-scoped ID
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID
Parameter Type Description pullRequestobject Pull request details ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Create a pull request between repository branches
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID titlestring Yes Pull request title sourceBranchstring Yes Source branch name destinationBranchstring Yes Destination branch name descriptionstring No Pull request description closeSourceBranchboolean No Close the source branch after merge draftboolean No Create the pull request as a draft reviewerUuidsarray No Bitbucket account UUIDs to add as reviewers
Parameter Type Description pullRequestobject Created pull request ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Start an asynchronous pull request merge and return a task to poll when needed
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID mergeStrategystring No Merge strategy: merge_commit, squash, fast_forward, squash_fast_forward, rebase_fast_forward, or rebase_merge messagestring No Merge commit message (maximum 128 KiB encoded as UTF-8) closeSourceBranchboolean No Delete the source branch after merging
Parameter Type Description statusstring Whether the merge completed or remains pending taskIdstring Async merge task ID taskUrlstring Validated task polling URL pullRequestobject Merged pull request when completed synchronously ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Poll the status of an asynchronous pull request merge task
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID taskIdstring Yes Merge task ID returned by Bitbucket Merge Pull Request
Parameter Type Description taskStatusstring PENDING or SUCCESS selfUrlstring Merge task API URL mergeResultobject Merged pull request when the task succeeds ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Decline an open pull request
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID
Parameter Type Description pullRequestobject Declined pull request ↳ type string Bitbucket pull request object type ↳ id number Repository-scoped pull request ID ↳ title string Pull request title ↳ description string Pull request description ↳ state string Pull request state ↳ draft boolean Whether the pull request is a draft ↳ queued boolean Whether the pull request is queued ↳ author object Pull request author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ closedBy object Account that closed the pull request ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ source object Source endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ destination object Destination endpoint ↳ branchName string Branch name ↳ commitHash string Commit hash ↳ repositoryUuid string Repository UUID ↳ repositoryFullName string Repository full name ↳ mergeCommitHash string Merge commit hash ↳ commentCount number Comment count ↳ taskCount number Open task count ↳ closeSourceBranch boolean Whether merging closes the source branch ↳ reason string Reason the pull request was declined ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ reviewers array Explicit reviewers ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ participants array Pull request participants ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action ↳ selfUrl string Pull request API URL ↳ htmlUrl string Pull request web URL
Approve a pull request as the authenticated account
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID
Parameter Type Description participantobject Approval participant record ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action
Request changes on a pull request as the authenticated account
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID
Parameter Type Description participantobject Change-request participant record ↳ type string Bitbucket participant object type ↳ user object Participating account ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ role string Participant role ↳ approved boolean Whether the participant approved ↳ state string Review state ↳ participatedOn string Timestamp of the participant action
Read a bounded UTF-8 unified diff for one pull request file
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID pathstring Yes Repository-relative file path to include in the diff maxCharactersnumber No Maximum diff characters to return (1-500000)
Parameter Type Description diffstring Bounded unified diff text decoded as UTF-8 decodingLossyboolean Whether invalid UTF-8 source bytes were replaced while decoding truncatedboolean Whether later diff text was omitted returnedBytesnumber Provider bytes read for the returned diff fullBytesnumber Full diff byte size when reported
List per-file change statistics for a pull request
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Per-file diff statistics ↳ type string Diffstat object type ↳ status string File change status ↳ linesAdded number Lines added ↳ linesRemoved number Lines removed ↳ oldPath string Old file path ↳ newPath string New file path ↳ oldCommitHash string Old file commit hash ↳ newCommitHash string New file commit hash
List global, inline, and reply comments on a pull request
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID qstring No Bitbucket comment filtering expression sortstring No Bitbucket comment sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Pull request comments ↳ type string Bitbucket comment object type ↳ id number Comment ID ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ content string Raw comment content ↳ user object Comment author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ deleted boolean Whether the comment was deleted ↳ parentId number Parent comment ID ↳ inline object Inline comment anchor ↳ path string Anchored file path ↳ from number Ending line in the old file ↳ to number Ending line in the new file ↳ startFrom number Starting line in the old file ↳ startTo number Starting line in the new file ↳ pending boolean Whether the comment is pending ↳ resolution object Comment resolution details ↳ resolver object Account that resolved the comment ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ resolvedOn string Resolution timestamp ↳ selfUrl string Comment API URL ↳ htmlUrl string Comment web URL
Create a global comment or reply on a pull request
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID contentstring Yes Raw comment content parentIdnumber No Parent comment ID when creating a reply
Parameter Type Description commentobject Created comment ↳ type string Bitbucket comment object type ↳ id number Comment ID ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ content string Raw comment content ↳ user object Comment author ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ deleted boolean Whether the comment was deleted ↳ parentId number Parent comment ID ↳ inline object Inline comment anchor ↳ path string Anchored file path ↳ from number Ending line in the old file ↳ to number Ending line in the new file ↳ startFrom number Starting line in the old file ↳ startTo number Starting line in the new file ↳ pending boolean Whether the comment is pending ↳ resolution object Comment resolution details ↳ resolver object Account that resolved the comment ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ resolvedOn string Resolution timestamp ↳ selfUrl string Comment API URL ↳ htmlUrl string Comment web URL
List commit statuses associated with a pull request
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID prIdnumber Yes Repository-scoped pull request ID qstring No Bitbucket commit status filtering expression sortstring No Bitbucket commit status sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Pull request commit statuses ↳ type string Bitbucket commit-status object type ↳ key string Vendor-unique status key ↳ refName string Reference name at status creation time ↳ url string External build URL ↳ state string Commit status state ↳ name string Build name ↳ description string Build description ↳ createdOn string Creation timestamp ↳ updatedOn string Update timestamp ↳ selfUrl string Status API URL ↳ commitUrl string Commit API URL
List pipelines for a Bitbucket Cloud repository
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID refTypestring No Reference type filter: BRANCH, TAG, or ANNOTATED_TAG refNamestring No Reference name filter commitHashstring No Full 40-character target commit SHA-1 filter selectorTypestring No Selector type filter: BRANCH, TAG, CUSTOM, PULLREQUESTS, or DEFAULT selectorPatternstring No Pipeline selector pattern filter triggerTypestring No Trigger filter: PUSH, MANUAL, SCHEDULED, or PARENT_STEP statusstring No Pipeline status filter sortstring No Bitbucket pipeline sort expression nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Pipelines ↳ type string Bitbucket pipeline object type ↳ uuid string Pipeline UUID ↳ buildNumber number Pipeline build number ↳ creator object Pipeline creator ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ repositoryFullName string Repository full name ↳ target object Pipeline target ↳ type string Target object type ↳ refType string Reference type ↳ refName string Reference name ↳ commitHash string Target commit hash ↳ selectorType string Pipeline selector type ↳ selectorPattern string Pipeline selector pattern ↳ triggerType string Pipeline trigger object type ↳ state object Pipeline state ↳ name string State name ↳ stage string In-progress stage name ↳ result string Completed result name ↳ errorKey string Completed-error key ↳ errorMessage string Completed-error message ↳ createdOn string Creation timestamp ↳ completedOn string Completion timestamp ↳ buildSecondsUsed number Build seconds used ↳ selfUrl string Pipeline API URL ↳ stepsUrl string Pipeline steps API URL
Get a pipeline by UUID
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID pipelineUuidstring Yes Pipeline UUID
Parameter Type Description pipelineobject Pipeline details ↳ type string Bitbucket pipeline object type ↳ uuid string Pipeline UUID ↳ buildNumber number Pipeline build number ↳ creator object Pipeline creator ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ repositoryFullName string Repository full name ↳ target object Pipeline target ↳ type string Target object type ↳ refType string Reference type ↳ refName string Reference name ↳ commitHash string Target commit hash ↳ selectorType string Pipeline selector type ↳ selectorPattern string Pipeline selector pattern ↳ triggerType string Pipeline trigger object type ↳ state object Pipeline state ↳ name string State name ↳ stage string In-progress stage name ↳ result string Completed result name ↳ errorKey string Completed-error key ↳ errorMessage string Completed-error message ↳ createdOn string Creation timestamp ↳ completedOn string Completion timestamp ↳ buildSecondsUsed number Build seconds used ↳ selfUrl string Pipeline API URL ↳ stepsUrl string Pipeline steps API URL
Run the repository pipeline selected by a branch or ref target
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID refTypestring Yes Reference type: branch, tag, named_branch, or bookmark refNamestring Yes Reference name commitHashstring No Full 40-character commit SHA-1 to run in the reference context
Parameter Type Description pipelineobject Triggered pipeline ↳ type string Bitbucket pipeline object type ↳ uuid string Pipeline UUID ↳ buildNumber number Pipeline build number ↳ creator object Pipeline creator ↳ type string Bitbucket account object type ↳ uuid string Bitbucket account UUID ↳ accountId string Atlassian account ID ↳ displayName string Account display name ↳ createdOn string Account creation timestamp ↳ selfUrl string Account API URL ↳ htmlUrl string Account web URL ↳ avatarUrl string Account avatar URL ↳ repositoryFullName string Repository full name ↳ target object Pipeline target ↳ type string Target object type ↳ refType string Reference type ↳ refName string Reference name ↳ commitHash string Target commit hash ↳ selectorType string Pipeline selector type ↳ selectorPattern string Pipeline selector pattern ↳ triggerType string Pipeline trigger object type ↳ state object Pipeline state ↳ name string State name ↳ stage string In-progress stage name ↳ result string Completed result name ↳ errorKey string Completed-error key ↳ errorMessage string Completed-error message ↳ createdOn string Creation timestamp ↳ completedOn string Completion timestamp ↳ buildSecondsUsed number Build seconds used ↳ selfUrl string Pipeline API URL ↳ stepsUrl string Pipeline steps API URL
Stop a running pipeline
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID pipelineUuidstring Yes Pipeline UUID
Parameter Type Description stoppedboolean Whether the stop request succeeded
List the steps in a pipeline
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID pipelineUuidstring Yes Pipeline UUID nextUrlstring No Opaque next-page URL returned by a previous Bitbucket call pageLennumber No Results per page (1-100)
Parameter Type Description pageobject Pagination information ↳ size number Total result count reported by Bitbucket ↳ page number Current page number ↳ pageLen number Number of results requested per page ↳ nextUrl string Validated URL for the next page ↳ previousUrl string Validated URL for the previous page itemsarray Pipeline steps ↳ type string Bitbucket pipeline-step object type ↳ uuid string Pipeline step UUID ↳ startedOn string Step start timestamp ↳ completedOn string Step completion timestamp ↳ state object Pipeline step state ↳ name string State name ↳ result string Completed result name ↳ errorKey string Completed-error key ↳ errorMessage string Completed-error message ↳ imageName string Build container image name ↳ setupCommands array Setup commands ↳ name string Command name ↳ command string Executable command ↳ scriptCommands array Build script commands ↳ name string Command name ↳ command string Executable command
Read a bounded UTF-8 tail of a pipeline step log
Inputs and outputsParameter Type Required Description workspaceSlugstring Yes Bitbucket workspace slug or UUID repoSlugstring Yes Bitbucket repository slug or UUID pipelineUuidstring Yes Pipeline UUID stepUuidstring Yes Pipeline step UUID maxCharactersnumber No Maximum trailing log characters to return (1-200000)
Parameter Type Description logstring Bounded trailing UTF-8 log text truncatedboolean Whether earlier log output was omitted totalBytesnumber Full log byte size when reported
A trigger starts a workflow when a supported event occurs in this service.
Trigger workflow when a build status is created for a Bitbucket commit
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload commitStatusjson Bitbucket commit status object commitHashstring Hash of the commit with this status statusKeystring Key identifying the build status statusStatestring Current build status state statusNamestring Display name of the build status statusUrlstring URL associated with the build status
Trigger workflow when a build status is updated for a Bitbucket commit
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload commitStatusjson Bitbucket commit status object commitHashstring Hash of the commit with this status statusKeystring Key identifying the build status statusStatestring Current build status state statusNamestring Display name of the build status statusUrlstring URL associated with the build status
Trigger workflow when a comment is created on a Bitbucket commit
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment commitjson Commit the comment was created on
Trigger workflow when approval is removed from a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch approvaljson Pull request approval details
Trigger workflow when a Bitbucket pull request is approved
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch approvaljson Pull request approval details
Trigger workflow when a changes request is removed from a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch changesRequestjson Pull request changes-request details
Trigger workflow when changes are requested on a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch changesRequestjson Pull request changes-request details
Trigger workflow when a comment is created on a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment
Trigger workflow when a comment is deleted from a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment
Trigger workflow when a resolved comment is reopened on a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment
Trigger workflow when a comment is resolved on a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment
Trigger workflow when a comment is updated on a Bitbucket pull request
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch commentjson Bitbucket comment object commentIdnumber Repository-scoped comment ID commentContentstring Raw text content of the comment
Trigger workflow when a Bitbucket pull request is created
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch
Trigger workflow when a Bitbucket pull request is declined
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch
Trigger workflow when a Bitbucket pull request is merged
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch
Trigger workflow when a Bitbucket pull request is updated
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pullRequestjson Bitbucket pull request object pullRequestIdnumber Repository-scoped pull request ID pullRequestTitlestring Pull request title pullRequestStatestring Pull request state sourceBranchstring Pull request source branch destinationBranchstring Pull request destination branch
Trigger workflow when commits are pushed to a Bitbucket repository
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload pushjson Push details, including changes and commits
Trigger workflow when a Bitbucket repository is forked
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload forkjson Newly created repository fork
Trigger workflow when a Bitbucket repository is updated
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes The Bitbucket account used to create and remove the repository webhook. Repository administrator access is required. workspacePickerproject-selector Yes The workspace containing the repository to monitor. workspaceSlugInputstring Yes Enter the workspace slug directly instead of selecting a workspace. repositoryPickerproject-selector Yes The repository where Sim creates the webhook. repositorySlugInputstring Yes Enter the repository slug directly instead of selecting a repository.
Parameter Type Description eventTypestring Bitbucket event key from X-Event-Key hookUuidstring UUID of the Bitbucket repository webhook requestUuidstring Bitbucket delivery request UUID attemptNumbernumber Bitbucket delivery attempt number actorjson User or app that caused the event repositoryjson Repository where the event occurred payloadjson Full parsed Bitbucket webhook payload changesjson Repository fields changed by the update