Skip to main content

Synopsis

kosli assert pullrequest gitlab [flags]
Assert a Gitlab merge request for a git commit exists.
The command exits with non-zero exit code if no merge requests were found for the commit.

Flags

FlagDescription
—commit stringGit commit for which to find pull request evidence. (defaulted in some CIs: docs ). (default “HEAD”)
-D, —dry-run[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.
—gitlab-base-url string[optional] Gitlab base URL (only needed for on-prem Gitlab installations).
—gitlab-org stringGitlab organization. (defaulted if you are running in Gitlab Pipelines: docs ).
—gitlab-token stringGitlab token.
-h, —helphelp for gitlab
—repository stringGit repository. (defaulted in some CIs: docs ).

Flags inherited from parent commands

FlagDescription
-a, —api-token stringThe Kosli API token.
-c, —config-file string[optional] The Kosli config file path. (default “kosli”)
—debug[optional] Print debug logs to stdout. A boolean flag docs (default false)
-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 stringThe Kosli organization.

Examples Use Cases

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.
kosli assert mergerequest gitlab \
	--github-token yourGithubToken \
	--github-org yourGithubOrg \
	--commit yourGitCommit \
	--repository yourGithubGitRepository
Last modified on March 10, 2026