Can I use Bitbucket as a CLI?

Yes. KosmoKrator exposes a Bitbucket CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Bitbucket through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Bitbucket tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Bitbucket credentials stored?

Bitbucket credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Bitbucket MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Bitbucket Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Bitbucket KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.bitbucket.*. Use lua_read_doc("integrations.bitbucket") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Bitbucket workflow without starting an interactive agent session.

Inline Lua call

kosmo integrations:lua --eval 'dump(app.integrations.bitbucket.list_repos({workspace = "example_workspace", sort = "example_sort", pagelen = 1, page = "example_page"}))' --json

Read Lua docs headlessly

kosmo integrations:lua --eval 'print(docs.read("bitbucket"))' --json
kosmo integrations:lua --eval 'print(docs.read("bitbucket.list_repos"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua

local bitbucket = app.integrations.bitbucket
local result = bitbucket.list_repos({workspace = "example_workspace", sort = "example_sort", pagelen = 1, page = "example_page"})

dump(result)

Run the workflow

kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json

Namespace note. integrations:lua exposes app.integrations.bitbucket, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.bitbucket.default.* or app.integrations.bitbucket.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Bitbucket, use the narrower mcp:lua command.

MCP Lua command

# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

HTTP client for the Bitbucket REST API (v2) — Lua API Reference

bitbucket_create_branch

Create a new branch in a Bitbucket repository. Requires a branch name and the target commit hash..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`name`	string	yes	The name for the new branch.
`target_hash`	string	yes	The commit hash to branch from.

Example

local result = app.integrations.bitbucket.bitbucket_create_branch({
  workspace = ""
  repo_slug = ""
  name = ""
})

bitbucket_create_issue

Create a new issue in a Bitbucket repository. Requires a title; optionally set content, kind, priority, and assignee..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`title`	string	yes	The title of the issue.
`content`	string	no	The issue description (Markdown supported).
`kind`	string	no	Issue kind: bug, enhancement, proposal, task. Default: bug.
`priority`	string	no	Issue priority: trivial, minor, major, critical, blocker. Default: major.
`assignee`	string	no	The UUID of the user to assign the issue to.

Example

local result = app.integrations.bitbucket.bitbucket_create_issue({
  workspace = ""
  repo_slug = ""
  title = ""
})

bitbucket_create_pull_request

Create a new pull request in a Bitbucket repository. Requires a title, source branch, and destination branch..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`title`	string	yes	The title of the pull request.
`description`	string	no	The pull request description (Markdown supported).
`source_branch`	string	yes	The name of the source branch.
`destination_branch`	string	no	The name of the destination branch. Default: main.
`close_source_branch`	boolean	no	Whether to close the source branch after merge. Default: false.

Example

local result = app.integrations.bitbucket.bitbucket_create_pull_request({
  workspace = ""
  repo_slug = ""
  title = ""
})

bitbucket_create_repo

Create a new repository in a Bitbucket workspace. Optionally set description, visibility, and language..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The slug for the new repository.
`description`	string	no	A short description of the repository.
`is_private`	boolean	no	Whether the repository should be private. Default: true.
`language`	string	no	The main language of the repository (e.g.

Example

local result = app.integrations.bitbucket.bitbucket_create_repo({
  workspace = ""
  repo_slug = ""
  description = ""
})

bitbucket_get_file

Get the raw content of a file from a Bitbucket repository at a specific revision..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`revision`	string	yes	A commit hash, branch name, or tag.
`file_path`	string	yes	The path to the file within the repository.

Example

local result = app.integrations.bitbucket.bitbucket_get_file({
  workspace = ""
  repo_slug = ""
  revision = ""
})

bitbucket_get_issue

Get details for a specific issue in a Bitbucket repository..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`issue_id`	integer	yes	The issue identifier.

Example

local result = app.integrations.bitbucket.bitbucket_get_issue({
  workspace = ""
  repo_slug = ""
  issue_id = 0
})

bitbucket_get_pull_request

Get details for a specific pull request in a Bitbucket repository..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pr_id`	integer	yes	The pull request identifier.

Example

local result = app.integrations.bitbucket.bitbucket_get_pull_request({
  workspace = ""
  repo_slug = ""
  pr_id = 0
})

bitbucket_get_repo

Get details for a specific Bitbucket repository by workspace and repo slug..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.

Example

local result = app.integrations.bitbucket.bitbucket_get_repo({
  workspace = ""
  repo_slug = ""
})

bitbucket_list_branches

List branches in a Bitbucket repository. Supports pagination..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

Example

local result = app.integrations.bitbucket.bitbucket_list_branches({
  workspace = ""
  repo_slug = ""
  pagelen = 0
})

bitbucket_list_commits

List commits in a Bitbucket repository. Supports filtering by revision and path..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`revision`	string	no	A commit hash, branch name, or tag to list commits for.
`path`	string	no	Filter commits to those affecting a specific file path.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

Example

local result = app.integrations.bitbucket.bitbucket_list_commits({
  workspace = ""
  repo_slug = ""
  revision = ""
})

bitbucket_list_issues

List issues in a Bitbucket repository. Supports filtering by state, kind, and priority..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`state`	string	no	Filter by issue state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid.
`kind`	string	no	Filter by kind: bug, enhancement, proposal, task.
`priority`	string	no	Filter by priority: trivial, minor, major, critical, blocker.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

Example

local result = app.integrations.bitbucket.bitbucket_list_issues({
  workspace = ""
  repo_slug = ""
  state = ""
})

bitbucket_list_pull_requests

List pull requests in a Bitbucket repository. Supports filtering by state and pagination..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`state`	string	no	Filter by state: OPEN, MERGED, DECLINED, SUPERSEDED.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

Example

local result = app.integrations.bitbucket.bitbucket_list_pull_requests({
  workspace = ""
  repo_slug = ""
  state = ""
})

bitbucket_list_repos

List repositories in a Bitbucket workspace. Supports sorting and pagination..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`sort`	string	no	Sort field (e.g.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.
`page`	string	no	Page URL or page number for pagination.

Example

local result = app.integrations.bitbucket.bitbucket_list_repos({
  workspace = ""
  sort = ""
  pagelen = 0
})

bitbucket_merge_pull_request

Merge a Bitbucket pull request. Optionally provide a merge commit message..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pr_id`	integer	yes	The pull request identifier.
`merge_commit_message`	string	no	An optional message for the merge commit.

Example

local result = app.integrations.bitbucket.bitbucket_merge_pull_request({
  workspace = ""
  repo_slug = ""
  pr_id = 0
})

bitbucket_update_issue

Update an existing issue in a Bitbucket repository. Can change title, content, state, priority, and assignee..

Parameters

Name	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`issue_id`	integer	yes	The issue identifier.
`title`	string	no	The new title of the issue.
`content`	string	no	The new issue description (Markdown supported).
`state`	string	no	New state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid.
`priority`	string	no	New priority: trivial, minor, major, critical, blocker.
`assignee`	string	no	The UUID of the user to assign the issue to.

Example

local result = app.integrations.bitbucket.bitbucket_update_issue({
  workspace = ""
  repo_slug = ""
  issue_id = 0
})

Multi-Account Usage

If you have multiple bitbucket accounts configured, use account-specific namespaces:

-- Default account (always works)
app.integrations.bitbucket.function_name({...})

-- Explicit default (portable across setups)
app.integrations.bitbucket.default.function_name({...})

-- Named accounts
app.integrations.bitbucket.work.function_name({...})
app.integrations.bitbucket.personal.function_name({...})

All functions are identical across accounts — only the credentials differ.

Raw agent markdown

# HTTP client for the Bitbucket REST API (v2) — Lua API Reference

## bitbucket_create_branch

Create a new branch in a Bitbucket repository. Requires a branch name and the target commit hash..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `name` | string | yes | The name for the new branch. |
| `target_hash` | string | yes | The commit hash to branch from. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_create_branch({
  workspace = ""
  repo_slug = ""
  name = ""
})
```

## bitbucket_create_issue

Create a new issue in a Bitbucket repository. Requires a title; optionally set content, kind, priority, and assignee..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `title` | string | yes | The title of the issue. |
| `content` | string | no | The issue description (Markdown supported). |
| `kind` | string | no | Issue kind: bug, enhancement, proposal, task. Default: bug. |
| `priority` | string | no | Issue priority: trivial, minor, major, critical, blocker. Default: major. |
| `assignee` | string | no | The UUID of the user to assign the issue to. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_create_issue({
  workspace = ""
  repo_slug = ""
  title = ""
})
```

## bitbucket_create_pull_request

Create a new pull request in a Bitbucket repository. Requires a title, source branch, and destination branch..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `title` | string | yes | The title of the pull request. |
| `description` | string | no | The pull request description (Markdown supported). |
| `source_branch` | string | yes | The name of the source branch. |
| `destination_branch` | string | no | The name of the destination branch. Default: main. |
| `close_source_branch` | boolean | no | Whether to close the source branch after merge. Default: false. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_create_pull_request({
  workspace = ""
  repo_slug = ""
  title = ""
})
```

## bitbucket_create_repo

Create a new repository in a Bitbucket workspace. Optionally set description, visibility, and language..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The slug for the new repository. |
| `description` | string | no | A short description of the repository. |
| `is_private` | boolean | no | Whether the repository should be private. Default: true. |
| `language` | string | no | The main language of the repository (e.g.  |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_create_repo({
  workspace = ""
  repo_slug = ""
  description = ""
})
```

## bitbucket_get_file

Get the raw content of a file from a Bitbucket repository at a specific revision..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `revision` | string | yes | A commit hash, branch name, or tag. |
| `file_path` | string | yes | The path to the file within the repository. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_get_file({
  workspace = ""
  repo_slug = ""
  revision = ""
})
```

## bitbucket_get_issue

Get details for a specific issue in a Bitbucket repository..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `issue_id` | integer | yes | The issue identifier. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_get_issue({
  workspace = ""
  repo_slug = ""
  issue_id = 0
})
```

## bitbucket_get_pull_request

Get details for a specific pull request in a Bitbucket repository..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `pr_id` | integer | yes | The pull request identifier. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_get_pull_request({
  workspace = ""
  repo_slug = ""
  pr_id = 0
})
```

## bitbucket_get_repo

Get details for a specific Bitbucket repository by workspace and repo slug..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_get_repo({
  workspace = ""
  repo_slug = ""
})
```

## bitbucket_list_branches

List branches in a Bitbucket repository. Supports pagination..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `pagelen` | integer | no | Number of results per page (1-100). Default: 10. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_list_branches({
  workspace = ""
  repo_slug = ""
  pagelen = 0
})
```

## bitbucket_list_commits

List commits in a Bitbucket repository. Supports filtering by revision and path..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `revision` | string | no | A commit hash, branch name, or tag to list commits for. |
| `path` | string | no | Filter commits to those affecting a specific file path. |
| `pagelen` | integer | no | Number of results per page (1-100). Default: 10. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_list_commits({
  workspace = ""
  repo_slug = ""
  revision = ""
})
```

## bitbucket_list_issues

List issues in a Bitbucket repository. Supports filtering by state, kind, and priority..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `state` | string | no | Filter by issue state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid. |
| `kind` | string | no | Filter by kind: bug, enhancement, proposal, task. |
| `priority` | string | no | Filter by priority: trivial, minor, major, critical, blocker. |
| `pagelen` | integer | no | Number of results per page (1-100). Default: 10. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_list_issues({
  workspace = ""
  repo_slug = ""
  state = ""
})
```

## bitbucket_list_pull_requests

List pull requests in a Bitbucket repository. Supports filtering by state and pagination..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `state` | string | no | Filter by state: OPEN, MERGED, DECLINED, SUPERSEDED. |
| `pagelen` | integer | no | Number of results per page (1-100). Default: 10. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_list_pull_requests({
  workspace = ""
  repo_slug = ""
  state = ""
})
```

## bitbucket_list_repos

List repositories in a Bitbucket workspace. Supports sorting and pagination..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `sort` | string | no | Sort field (e.g.  |
| `pagelen` | integer | no | Number of results per page (1-100). Default: 10. |
| `page` | string | no | Page URL or page number for pagination. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_list_repos({
  workspace = ""
  sort = ""
  pagelen = 0
})
```

## bitbucket_merge_pull_request

Merge a Bitbucket pull request. Optionally provide a merge commit message..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `pr_id` | integer | yes | The pull request identifier. |
| `merge_commit_message` | string | no | An optional message for the merge commit. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_merge_pull_request({
  workspace = ""
  repo_slug = ""
  pr_id = 0
})
```

## bitbucket_update_issue

Update an existing issue in a Bitbucket repository. Can change title, content, state, priority, and assignee..

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace` | string | yes | The workspace slug or UUID. |
| `repo_slug` | string | yes | The repository slug. |
| `issue_id` | integer | yes | The issue identifier. |
| `title` | string | no | The new title of the issue. |
| `content` | string | no | The new issue description (Markdown supported). |
| `state` | string | no | New state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid. |
| `priority` | string | no | New priority: trivial, minor, major, critical, blocker. |
| `assignee` | string | no | The UUID of the user to assign the issue to. |

### Example

```lua
local result = app.integrations.bitbucket.bitbucket_update_issue({
  workspace = ""
  repo_slug = ""
  issue_id = 0
})
```

---

## Multi-Account Usage

If you have multiple bitbucket accounts configured, use account-specific namespaces:

```lua
-- Default account (always works)
app.integrations.bitbucket.function_name({...})

-- Explicit default (portable across setups)
app.integrations.bitbucket.default.function_name({...})

-- Named accounts
app.integrations.bitbucket.work.function_name({...})
app.integrations.bitbucket.personal.function_name({...})
```

All functions are identical across accounts — only the credentials differ.

Metadata-derived Lua example

local result = app.integrations.bitbucket.list_repos({workspace = "example_workspace", sort = "example_sort", pagelen = 1, page = "example_page"})
print(result)

Functions

list_repos Read

List repositories in a Bitbucket workspace. Supports sorting and pagination.

Lua path: app.integrations.bitbucket.list_repos
Full name: bitbucket.bitbucket_list_repos

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`sort`	string	no	Sort field (e.g. "-updated_on", "name", "-created_on").
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.
`page`	string	no	Page URL or page number for pagination.

get_repo Read

Get details for a specific Bitbucket repository by workspace and repo slug.

Lua path: app.integrations.bitbucket.get_repo
Full name: bitbucket.bitbucket_get_repo

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.

create_repo Write

Create a new repository in a Bitbucket workspace. Optionally set description, visibility, and language.

Lua path: app.integrations.bitbucket.create_repo
Full name: bitbucket.bitbucket_create_repo

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The slug for the new repository.
`description`	string	no	A short description of the repository.
`is_private`	boolean	no	Whether the repository should be private. Default: true.
`language`	string	no	The main language of the repository (e.g. "python", "javascript").

list_issues Read

List issues in a Bitbucket repository. Supports filtering by state, kind, and priority.

Lua path: app.integrations.bitbucket.list_issues
Full name: bitbucket.bitbucket_list_issues

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`state`	string	no	Filter by issue state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid.
`kind`	string	no	Filter by kind: bug, enhancement, proposal, task.
`priority`	string	no	Filter by priority: trivial, minor, major, critical, blocker.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

get_issue Read

Get details for a specific issue in a Bitbucket repository.

Lua path: app.integrations.bitbucket.get_issue
Full name: bitbucket.bitbucket_get_issue

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`issue_id`	integer	yes	The issue identifier.

create_issue Write

Create a new issue in a Bitbucket repository. Requires a title; optionally set content, kind, priority, and assignee.

Lua path: app.integrations.bitbucket.create_issue
Full name: bitbucket.bitbucket_create_issue

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`title`	string	yes	The title of the issue.
`content`	string	no	The issue description (Markdown supported).
`kind`	string	no	Issue kind: bug, enhancement, proposal, task. Default: bug.
`priority`	string	no	Issue priority: trivial, minor, major, critical, blocker. Default: major.
`assignee`	string	no	The UUID of the user to assign the issue to.

update_issue Write

Update an existing issue in a Bitbucket repository. Can change title, content, state, priority, and assignee.

Lua path: app.integrations.bitbucket.update_issue
Full name: bitbucket.bitbucket_update_issue

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`issue_id`	integer	yes	The issue identifier.
`title`	string	no	The new title of the issue.
`content`	string	no	The new issue description (Markdown supported).
`state`	string	no	New state: new, open, resolved, closed, on hold, wontfix, duplicate, invalid.
`priority`	string	no	New priority: trivial, minor, major, critical, blocker.
`assignee`	string	no	The UUID of the user to assign the issue to.

list_pull_requests Read

List pull requests in a Bitbucket repository. Supports filtering by state and pagination.

Lua path: app.integrations.bitbucket.list_pull_requests
Full name: bitbucket.bitbucket_list_pull_requests

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`state`	string	no	Filter by state: OPEN, MERGED, DECLINED, SUPERSEDED.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

get_pull_request Read

Get details for a specific pull request in a Bitbucket repository.

Lua path: app.integrations.bitbucket.get_pull_request
Full name: bitbucket.bitbucket_get_pull_request

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pr_id`	integer	yes	The pull request identifier.

create_pull_request Write

Create a new pull request in a Bitbucket repository. Requires a title, source branch, and destination branch.

Lua path: app.integrations.bitbucket.create_pull_request
Full name: bitbucket.bitbucket_create_pull_request

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`title`	string	yes	The title of the pull request.
`description`	string	no	The pull request description (Markdown supported).
`source_branch`	string	yes	The name of the source branch.
`destination_branch`	string	no	The name of the destination branch. Default: main.
`close_source_branch`	boolean	no	Whether to close the source branch after merge. Default: false.

merge_pull_request Write

Merge a Bitbucket pull request. Optionally provide a merge commit message.

Lua path: app.integrations.bitbucket.merge_pull_request
Full name: bitbucket.bitbucket_merge_pull_request

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pr_id`	integer	yes	The pull request identifier.
`merge_commit_message`	string	no	An optional message for the merge commit.

list_branches Read

List branches in a Bitbucket repository. Supports pagination.

Lua path: app.integrations.bitbucket.list_branches
Full name: bitbucket.bitbucket_list_branches

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

create_branch Write

Create a new branch in a Bitbucket repository. Requires a branch name and the target commit hash.

Lua path: app.integrations.bitbucket.create_branch
Full name: bitbucket.bitbucket_create_branch

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`name`	string	yes	The name for the new branch.
`target_hash`	string	yes	The commit hash to branch from.

list_commits Read

List commits in a Bitbucket repository. Supports filtering by revision and path.

Lua path: app.integrations.bitbucket.list_commits
Full name: bitbucket.bitbucket_list_commits

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`revision`	string	no	A commit hash, branch name, or tag to list commits for.
`path`	string	no	Filter commits to those affecting a specific file path.
`pagelen`	integer	no	Number of results per page (1-100). Default: 10.

get_file Read

Get the raw content of a file from a Bitbucket repository at a specific revision.

Lua path: app.integrations.bitbucket.get_file
Full name: bitbucket.bitbucket_get_file

Parameter	Type	Required	Description
`workspace`	string	yes	The workspace slug or UUID.
`repo_slug`	string	yes	The repository slug.
`revision`	string	yes	A commit hash, branch name, or tag.
`file_path`	string	yes	The path to the file within the repository.