Skip to content

kosli_assert_pullrequest_bitbucket.md

Latest commit

 

History

History
54 lines (43 loc) · 3.32 KB

kosli_assert_pullrequest_bitbucket.md

File metadata and controls

54 lines (43 loc) · 3.32 KB
Raw
title kosli assert pullrequest bitbucket
description Assert a Bitbucket pull request for a git commit exists.

Synopsis

kosli assert pullrequest bitbucket [flags]

Assert a Bitbucket pull request for a git commit exists.
The command exits with non-zero exit code if no pull requests were found for the commit. Authentication to Bitbucket can be done with an access token (recommended) or an Atlassian API token, passed via --bitbucket-username (your Atlassian account email) and --bitbucket-password. Bitbucket app passwords are no longer supported as of 28 July 2026; replace any app passwords with API tokens. Credentials need to have read access for both repos and pull requests.

Flags

Flag Type Description
--bitbucket-access-token string Bitbucket repo/project/workspace access token. See Bitbucket access tokens for more details.
--bitbucket-password string Bitbucket API token. Bitbucket app passwords are no longer supported as of 28 July 2026. See Bitbucket authentication for more details.
--bitbucket-username string Bitbucket username (your Atlassian account email when using an API token). Only needed if you use --bitbucket-password
--bitbucket-workspace string Bitbucket workspace ID.
--commit string Git commit for which to find pull request evidence. (defaulted in some CIs: docs ). (default "HEAD")
-D, --dry-run bool [optional] Run in dry-run mode. When enabled, no data is sent to Kosli and the CLI exits with 0 exit code regardless of any errors.
-h, --help bool help for bitbucket
--repository string Git repository. (defaulted in some CIs: docs ).

Flags inherited from parent commands

Flag Type Description
-a, --api-token string The Kosli API token.
-c, --config-file string [optional] The Kosli config file path. Config is read from this path or the default only, never implicitly from the current directory. (default "$HOME/.kosli.yml")
--debug bool [optional] Print debug logs to stdout.
-H, --host string [defaulted] The Kosli endpoint. (default "https://app.kosli.com")
--http-proxy string [optional] The HTTP proxy URL including protocol and port number. e.g. http://proxy-server-ip:proxy-port
-r, --max-api-retries int [defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
--org string The Kosli organization.
-q, --quiet bool [optional] Suppress non-critical warning messages. Errors and normal output are not affected. If both --quiet and --debug are set, --debug wins.

Examples Use Cases

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.

kosli assert pullrequest bitbucket  \
	--bitbucket-access-token yourBitbucketAccessToken \
	--bitbucket-workspace yourBitbucketWorkspace \
	--commit yourGitCommit \
	--repository yourBitbucketGitRepository