> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Codacy

The Codacy connector lets your AI agent act in each user's Codacy account. Each user connects their own Codacy API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Developer Tools, Monitoring
**Tools:** 60: 47 read, 12 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CODACY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Codacy connection

   In **AgentKit > Connections**, create a Codacy connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'codacy'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Codacy:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'codacy_tools_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "codacy"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Codacy:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="codacy_tools_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Codacy credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'codacy_category_overviews_list',
  toolInput: {
    provider: 'gh',
    remote_organization_name: '<remote_organization_name>',
    repository_name: '<repository_name>',
  },
  connector: 'codacy',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="codacy_category_overviews_list",
    tool_input={
        "provider": "gh",
        "remote_organization_name": "<remote_organization_name>",
        "repository_name": "<repository_name>",
    },
    connection_name="codacy",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `codacy_category_overviews_list`

List Category Overviews · Read-only

Get the number of Codacy issues per category, such as Security or Code Style, for a branch.
Returns each category with its issue count and share.
Use Search Issues to list the issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_coding_standard_get`

Get Coding Standard · Read-only

Get one Codacy coding standard.
Returns its name, languages, enabled tools and linked repository count.
Use List Coding Standards to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `coding_standard_id` (`integer`, required): Coding standard ID, from List Coding Standards. Example: 12.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.

Example input: `{"coding_standard_id":12,"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_coding_standards_list`

List Coding Standards · Read-only

List the coding standards (shared tool and pattern configurations) of a Codacy organization.
Returns each standard's id, name, default flag and languages.
Use Apply Coding Standard to link repositories.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_commit_delta_issues_list`

List Commit Delta Issues · Read-only

List the issues a commit added or fixed compared with its parent or another commit.
Returns each issue's status (new or fixed), pattern, severity, file and line.
Set targetCommitUuid to compare two commits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `src_commit_uuid` (`string`, required): Commit SHA to inspect. Example: 2957025d42e8daadf937d4044516f991d21deea4.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `only_potential` (`boolean`, optional): Set to `true` to return only potential issues. Example: false.
- `status` (`string`, optional): Filter issues by status. Valid values are `all`, `new`, or `fixed`. Example: new. One of: `all`, `new`, `fixed`.
- `target_commit_uuid` (`string`, optional): Commit SHA to compare with; defaults to the parent commit. Example: 1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>","src_commit_uuid":"<src_commit_uuid>"}`

### `codacy_commit_delta_statistics_get`

Get Commit Delta Statistics · Read-only

Get the quality changes a commit introduced in Codacy.
Returns new and fixed issue counts and complexity, duplication and coverage variation.
Use Get Commit Analysis for the full commit view.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `commit_uuid` (`string`, required): Commit SHA, from List Repository Commits. Example: 2957025d42e8daadf937d4044516f991d21deea4.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"commit_uuid":"<commit_uuid>","provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_commit_get`

Get Commit Analysis · Read-only

Get the Codacy analysis of one commit.
Returns new and fixed issues, complexity, duplication and coverage deltas.
Use List Commit Delta Issues for the issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `commit_uuid` (`string`, required): Commit SHA, from List Repository Commits. Example: 2957025d42e8daadf937d4044516f991d21deea4.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"commit_uuid":"<commit_uuid>","provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_commit_statistics_list`

List Commit Statistics · Read-only

Get daily Codacy analysis statistics of a repository branch for recent days.
Returns per-day issues, complexity, duplication and coverage numbers.
Use it to chart quality over time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.
- `days` (`integer`, optional): Number of days of data to return (1-365, defaults to 31). Example: 30.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_commits_list`

List Repository Commits · Read-only

List the analyzed commits of a Codacy repository branch.
Returns each commit's SHA, author, message, date and quality deltas.
Use Get Commit Analysis for one commit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_coverage_reports_list`

List Coverage Reports · Read-only

List the latest coverage reports uploaded to a Codacy repository.
Returns each report's commit, language, status and upload time.
Use it to check coverage uploads are working.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_file_coverage_get`

Get File Coverage · Read-only

Get the line coverage of one file in Codacy.
Returns covered and uncovered lines and the coverage percentage.
Use List Files to find the file ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`integer`, required): Codacy file ID, from List Files. Example: 12345.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"file_id":12345,"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_file_get`

Get File Analysis · Read-only

Get the Codacy analysis of one file.
Returns its grade, issues, complexity, duplication and coverage.
Use Get File Issues for the issues in it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`integer`, required): Codacy file ID, from List Files. Example: 12345.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"file_id":12345,"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_file_issues_list`

Get File Issues · Read-only

List the Codacy issues in one file.
Returns each issue's pattern, severity, line and message.
Use List Files to find the file ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`integer`, required): Codacy file ID, from List Files. Example: 12345.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"file_id":12345,"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_files_list`

List Files · Read-only

List the files of a Codacy repository branch with their quality metrics.
Returns each file's id, path, grade, issues, complexity, duplication and coverage.
Use a file ID with Get File Analysis.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `direction` (`string`, optional): Sort direction. Possible values are 'asc' (ascending) or 'desc' (descending). Example: desc.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `path` (`string`, optional): Relative path of the folder whose direct child files are listed. When absent, all files in the repository are returned (recursive). When empty, only files at the repository root are returned. Example: src/.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `sort` (`string`, optional): Field used to sort the results. For files the valid values are `filename`, `issues`, `grade`, `duplication`, `complexity`, and `coverage`. For folders the valid values are `name`, `issues`, `grade`, `duplication`, `complexity`, and `coverage`. Example: issues.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_gate_policies_list`

List Gate Policies · Read-only

List the quality gate policies of a Codacy organization.
Returns each policy's id, name and default flag.
Use Get Gate Policy for its rules.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_gate_policy_get`

Get Gate Policy · Read-only

Get one Codacy quality gate policy.
Returns its name and the thresholds for issues, complexity, duplication and coverage.
Use List Gate Policies to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `gate_policy_id` (`integer`, required): Gate policy ID, from List Gate Policies. Example: 7.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.

Example input: `{"gate_policy_id":7,"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_issue_get`

Get Issue · Read-only

Get one open Codacy issue.
Returns its pattern, severity, category, file, line, message and commit.
Use Search Issues to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `issue_id` (`integer`, required): Codacy issue ID, from Search Issues. Example: 67890.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"issue_id":67890,"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_issues_overview_get`

Get Issues Overview · Read-only

Count the open Codacy issues of a repository by category, severity, language, tag, pattern and author, with filters.
Returns counts grouped by each dimension.
Use Search Issues to list them.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `author_emails` (`array`, optional): Set of commit author email addresses. Example: ["dev@example.com"].
- `branch_name` (`string`, optional): Branch name in the repository. Example: main.
- `categories` (`array`, optional): Set of issue categories. Example: ["Security"].
- `languages` (`array`, optional): Set of language names, without spaces. Example: ["JavaScript"].
- `levels` (`array`, optional): Set of issue severity levels. Example: ["Error"].
- `pattern_ids` (`array`, optional): Set of code pattern identifiers, as returned by the endpoint listPatterns. Example: ["ESLint8_no-unused-vars"].
- `potential_false_positives` (`boolean`, optional): If true, only issues that are potential false positives will be included in the search, if false, only issues that are not potential false positives will be included in the search. Example: false.
- `tags` (`array`, optional): Set of issue pattern tags. Example: ["cwe-79"].
- `tool_uuids` (`array`, optional): Set of tool UUIDs to filter issues by the tools that detected them. Example: ["847feb32-9ff2-11ea-bb37-0242ac130002"].

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_issues_search`

Search Issues · Read-only

Search the open Codacy issues of a repository by branch, pattern, tool, language, category, severity, tag or author.
Returns a page of issues with id, pattern, severity, file, line and message.
Use Get Issues Overview for counts only.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `author_emails` (`array`, optional): Set of commit author email addresses. Example: ["dev@example.com"].
- `branch_name` (`string`, optional): Branch name in the repository. Example: main.
- `categories` (`array`, optional): Set of issue categories. Example: ["Security"].
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `languages` (`array`, optional): Set of language names, without spaces. Example: ["JavaScript"].
- `levels` (`array`, optional): Set of issue severity levels. Example: ["Error"].
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `pattern_ids` (`array`, optional): Set of code pattern identifiers, as returned by the endpoint listPatterns. Example: ["ESLint8_no-unused-vars"].
- `potential_false_positives` (`boolean`, optional): If true, only issues that are potential false positives will be included in the search, if false, only issues that are not potential false positives will be included in the search. Example: false.
- `tags` (`array`, optional): Set of issue pattern tags. Example: ["cwe-79"].
- `tool_uuids` (`array`, optional): Set of tool UUIDs to filter issues by the tools that detected them. Example: ["847feb32-9ff2-11ea-bb37-0242ac130002"].

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_organization_get`

Get Organization · Read-only

Get one Codacy organization.
Returns its name, provider, plan and settings.
Use List My Organizations to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_organization_people_list`

List Organization People · Read-only

List the people in a Codacy organization.
Returns each person's name, email, role and last login.
Set onlyMembers to exclude committers who are not members.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `only_members` (`boolean`, optional): If true, returns only Codacy users. If false, returns also commit authors that are not Codacy users. Example: true.
- `search` (`string`, optional): Text to filter results by name. Example: api.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_organization_pull_requests_list`

List Organization Pull Requests · Read-only

List recent pull requests across a Codacy organization's repositories.
Returns each pull request with its repository, status, quality gate result and new issues.
Use List Pull Requests for one repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `repositories` (`string`, optional): **Deprecated:** Use searchOrganizationRepositoriesWithAnalysis instead. Example: awesome-repo.
- `search` (`string`, optional): Text to filter results by name. Example: api.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_organization_repositories_list`

List Organization Repositories · Read-only

List the repositories of a Codacy organization, with search and language filters.
Returns each repository's name, visibility, languages and whether Codacy analyzes it.
Use List Analyzed Repositories for grades and issue counts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `filter` (`string`, optional): Filter for which repositories to return. Use `Synced` for repositories the user has access to, `NotSynced` for repositories fetched from the provider, or `AllSynced` for all organization repositories (requires admin access). Example: AllSynced. One of: `Synced`, `NotSynced`, `AllSynced`.
- `languages` (`string`, optional): Comma-separated list of programming languages to filter results by. Example: JavaScript.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `segments` (`string`, optional): Filter by a comma-separated list of segment identifiers. Example: 1.
- `stack_tags` (`string`, optional): Comma-separated list of detected stack tags to filter repositories by. Example: react.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_pull_request_commits_list`

List Pull Request Commits · Read-only

List the commits of a pull request with their Codacy analysis.
Returns each commit's SHA, author, message and quality deltas.
Use Get Commit Analysis for one commit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_coverage_get`

Get Pull Request Coverage · Read-only

Get the code coverage of a pull request in Codacy.
Returns diff coverage, coverage variation and the coverage report status.
Use Get Pull Request Files Coverage per file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_files_coverage_get`

Get Pull Request Files Coverage · Read-only

Get the code coverage of each file changed in a pull request.
Returns each file's coverage and coverage change.
Use Get Pull Request Coverage for the totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_files_list`

List Pull Request Files · Read-only

List the files changed in a pull request with their Codacy quality deltas.
Returns each file's path, new and fixed issues, complexity, duplication and coverage change.
Use List Pull Request Issues for issue details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `column_order` (`string`, optional): Sort direction. The possible values are `asc` (ascending - default) or `desc` (descending). Example: desc. One of: `asc`, `desc`.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `sort_column` (`string`, optional): Field used to sort the results. The possible values are `deltaCoverage` (to sort by the coverage variation value of the files), `totalCoverage` (to sort by the total coverage value of the files) or `filename` (default - to sort by the name of the files). Example: deltaCoverage. One of: `totalCoverage`, `deltaCoverage`, `filename`.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_get`

Get Pull Request · Read-only

Get the Codacy analysis of one pull request.
Returns new and fixed issues, complexity and duplication deltas, coverage and the quality gate result.
Use List Pull Request Issues for the issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_issues_list`

List Pull Request Issues · Read-only

List the issues Codacy found in a pull request.
Returns each issue's pattern, severity, file, line and message.
Use status new or fixed to see what the pull request introduces or removes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `pull_request_number` (`integer`, required): Pull request number on the Git provider. Example: 42.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `only_potential` (`boolean`, optional): Set to `true` to return only potential issues. Example: false.
- `status` (`string`, optional): Filter issues by status. Valid values are `all`, `new`, or `fixed`. Example: new. One of: `all`, `new`, `fixed`.

Example input: `{"provider":"gh","pull_request_number":42,"remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_request_quality_settings_get`

Get Pull Request Quality Gate · Read-only

Get the quality gate rules Codacy applies to pull requests of a repository.
Returns thresholds for new issues, complexity, duplication and coverage.
Use Get Repository Quality Goals for repository goals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_pull_requests_list`

List Pull Requests · Read-only

List the pull requests of a Codacy repository, with search and target branch filters.
Returns each pull request's number, title, status, quality gate result and issue deltas.
Use Get Pull Request for one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `include_not_analyzed` (`boolean`, optional): If true, also return pull requests that weren't analyzed. Example: false.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `target_branch` (`string`, optional): Filter pull requests by the name of their target branch. Pull requests targeting any other branch are excluded from the results. By default, pull requests targeting any branch are returned. Example: main.
- `text_query` (`string`, optional): Filter pull requests by a free-text search matched, case-insensitively, against the pull request title or the author's handle. Example: fix login.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repositories_analysis_list`

List Analyzed Repositories · Read-only

List an organization's repositories with their Codacy analysis summary.
Returns each repository's grade, issue count, complexity, duplication and coverage.
Use Get Repository Analysis for one repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `repositories` (`string`, optional): **Deprecated:** Use searchOrganizationRepositoriesWithAnalysis instead. Example: awesome-repo.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `segments` (`string`, optional): Filter by a comma-separated list of segment identifiers. Example: 1.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_repository_analysis_get`

Get Repository Analysis · Read-only

Get the Codacy analysis summary of a repository branch.
Returns grade, issues, complexity, duplication, coverage and last analyzed commit.
Use List Category Overviews for issues by category.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_analysis_progress_get`

Get Analysis Progress · Read-only

Get the progress of a Codacy repository's first analysis.
Returns the analysis status and steps.
Use it right after Add Repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `branch` (`string`, optional): Branch name; defaults to the repository's main branch. Example: main.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_branches_list`

List Branches · Read-only

List the branches of a Codacy repository, optionally only analyzed ones.
Returns each branch's name, whether it is enabled and its last analysis.
Use Update Branch to turn analysis on or off.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `direction` (`string`, optional): Sort direction. Possible values are 'asc' (ascending) or 'desc' (descending). Example: asc.
- `enabled` (`boolean`, optional): Filter by branch status. Set to `true` to return only enabled branches, or `false` to return only disabled branches. Example: true.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `sort` (`string`, optional): Field used to sort the list of branches. The allowed values are 'name' and 'last-updated'. Example: name.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_get`

Get Repository · Read-only

Get one Codacy repository's settings and status.
Returns its name, visibility, default branch, languages and problems.
Use Get Repository Analysis for grades and metrics.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_quality_settings_get`

Get Repository Quality Goals · Read-only

Get the quality goals of a Codacy repository, such as maximum issue percentage and minimum coverage.
Returns the configured thresholds.
Use Get Pull Request Quality Gate for pull request rules.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_tool_patterns_list`

List Repository Tool Patterns · Read-only

List the patterns (rules) of a tool in a Codacy repository, filtered by language, category, severity, tags or state.
Returns each pattern's id, title, category, severity and whether it is enabled.
Use Update Repository Tool Patterns to switch matching patterns on or off.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `tool_uuid` (`string`, required): UUID of the analysis tool, from List Tools or List Repository Tools. Example: 847feb32-9ff2-11ea-bb37-0242ac130002.
- `categories` (`string`, optional): Filter by a comma-separated list of code pattern categories. Valid values are `Security`, `ErrorProne`, `CodeStyle`, `Compatibility`, `UnusedCode`, `Complexity`, `Comprehensibility`, `Documentation`, `BestPractice`, and `Performance`. Example: Security.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `direction` (`string`, optional): Sort direction. Possible values are 'asc' (ascending) or 'desc' (descending). Example: desc.
- `enabled` (`boolean`, optional): Filter by pattern status. Set to `true` to return only enabled patterns, or `false` to return only disabled patterns. Example: true.
- `languages` (`string`, optional): Comma-separated list of programming languages to filter results by. Example: JavaScript.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `matches_stack` (`boolean`, optional): Filter repository code patterns by whether they match the repository stack. Example: true.
- `recommended` (`boolean`, optional): Filter by recommended status. Set to `true` to return only recommended patterns, or `false` to return only non-recommended patterns. Example: true.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `severity_levels` (`string`, optional): Filter by a comma-separated list of code pattern severity levels. Valid values are `Error`, `High`, `Warning`, and `Info`. Example: Error.
- `sort` (`string`, optional): Field used to sort the tool's code patterns. Valid values are `category`, `recommended`, and `severity`. Example: severity.
- `tags` (`string`, optional): Filter by a comma-separated list of pattern tags. Example: cwe-79.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>","tool_uuid":"<tool_uuid>"}`

### `codacy_repository_tools_list`

List Repository Tools · Read-only

List the analysis tools of a Codacy repository and whether each is enabled.
Returns each tool's UUID, name, enabled state and config-file use.
Use Configure Repository Tool to change one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_security_dashboard_get`

Get Security Dashboard · Read-only

Get an organization's Codacy security dashboard metrics, filtered by repository, priority, category or scan type.
Returns open and overdue finding counts and remediation metrics.
Use Search Security Findings for the findings.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `categories` (`array`, optional): Security categories to filter by. Use `_other_` to search for issues that don't have a security category. Example: ["XSS"].
- `priorities` (`array`, optional): Security issue priorities to filter by. See SrmPriority for valid values. Example: ["High"].
- `repositories` (`array`, optional): Repository names to filter by. Example: ["awesome-repo"].
- `scan_types` (`array`, optional): Scan types to filter by. Example: ["SAST"].
- `segments` (`array`, optional): Segments ids to filter by. Example: [1].

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_security_finding_get`

Get Security Finding · Read-only

Get one Codacy security finding.
Returns its title, priority, status, category, repository, location and due date.
Use Search Security Findings to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `srm_item_id` (`string`, required): Security finding ID (UUID), from Search Security Findings. Example: 80f64371-e6bc-4d9b-b022-7c873cc5e39f.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","srm_item_id":"<srm_item_id>"}`

### `codacy_security_findings_search`

Search Security Findings · Read-only

Search an organization's Codacy security findings by repository, priority, status, category or scan type.
Returns a page of findings with id, title, priority, status, repository and due date.
Use Get Security Finding for one.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `categories` (`array`, optional): Security categories to filter by. Use `_other_` to search for issues that don't have a security category. Example: ["XSS"].
- `container_image` (`object`, optional): Filter for container scanning items. The image `name` is required; `tag` is optional. Filtering by tag alone (without name) is not allowed. Example: {"name": "api", "tag": "latest"}.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `dast_target_urls` (`array`, optional): Filter containing a list of Dast target urls. Example: ["https://app.example.com"].
- `direction` (`string`, optional): Sort direction. Possible values are 'asc' (ascending) or 'desc' (descending). Example: desc.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.
- `priorities` (`array`, optional): Security issue priorities to filter by. See SrmPriority for valid values. Example: ["High"].
- `repositories` (`array`, optional): Repository names to filter by. Example: ["awesome-repo"].
- `scan_types` (`array`, optional): Scan types to filter by. Example: ["SAST"].
- `search_text` (`string`, optional): Text to search for in security items. Example: injection.
- `segments` (`array`, optional): Segments ids to filter by. Example: [1].
- `sort` (`string`, optional): Field to sort SRM items by. Example: DetectedAt. One of: `Status`, `DetectedAt`.
- `statuses` (`array`, optional): Security issue status to filter by. See SrmStatus for valid values. Example: ["Overdue"].

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_tool_pattern_get`

Get Tool Pattern · Read-only

Get one pattern (rule) of a Codacy analysis tool.
Returns its title, description, explanation, category, severity and parameters.
Use List Tool Patterns to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pattern_id` (`string`, required): Pattern (rule) ID, from List Tool Patterns. Example: ESLint8_no-unused-vars.
- `tool_uuid` (`string`, required): UUID of the analysis tool, from List Tools or List Repository Tools. Example: 847feb32-9ff2-11ea-bb37-0242ac130002.

Example input: `{"pattern_id":"<pattern_id>","tool_uuid":"<tool_uuid>"}`

### `codacy_tool_patterns_list`

List Tool Patterns · Read-only

List the patterns (rules) of a Codacy analysis tool.
Returns each pattern's id, title, category, severity and default state.
Use Get Tool Pattern for one pattern's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tool_uuid` (`string`, required): UUID of the analysis tool, from List Tools or List Repository Tools. Example: 847feb32-9ff2-11ea-bb37-0242ac130002.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `enabled` (`boolean`, optional): Filter by enabled status. Set to `true` to return only enabled patterns, or `false` to return only disabled patterns. Example: true.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"tool_uuid":"<tool_uuid>"}`

### `codacy_tools_list`

List Tools · Read-only

List the analysis tools Codacy supports.
Returns each tool's UUID, name, languages and whether it is client-side.
Use a tool UUID with the pattern tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{}`

### `codacy_user_get`

Get Current User · Read-only

Get the Codacy user that owns the account API token.
Returns the user's id, name, main email and other emails.
Use it to confirm which account the token belongs to.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `codacy_user_organizations_by_provider_list`

List My Organizations By Provider · Read-only

List the token user's Codacy organizations on one Git provider.
Returns each organization's name and identifier.
Use List My Organizations for every provider.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{"provider":"gh"}`

### `codacy_user_organizations_list`

List My Organizations · Read-only

List the Codacy organizations the token's user belongs to, across Git providers.
Returns each organization's name, provider and identifier.
Use the provider and name in every organization tool.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for the next page, from the previous response's pagination.cursor. Omit for the first page. Example: Yms345gh==.
- `limit` (`integer`, optional): Maximum number of items to return, 1 to 100. Example: 20.

Example input: `{}`

### `codacy_coding_standard_repositories_apply`

Apply Coding Standard · Write

Link repositories to a Codacy coding standard, or unlink them.
Returns the result per repository.
Send both lists; either may be empty.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `coding_standard_id` (`integer`, required): Coding standard ID, from List Coding Standards. Example: 12.
- `link` (`array`, required): Repository names to link to the coding standard. Example: ["awesome-repo"].
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `unlink` (`array`, required): Repository names to unlink from it. Example: [].

Example input: `{"coding_standard_id":12,"link":["awesome-repo"],"provider":"gh","remote_organization_name":"<remote_organization_name>","unlink":[]}`

### `codacy_commit_reanalyze`

Reanalyze Commit · Write

Ask Codacy to analyze a commit again, optionally clearing the cache.
Returns an empty success response; analysis runs in the background.
Use Get Commit Analysis to see the new results.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `commit_uuid` (`string`, required): Commit SHA, from List Repository Commits. Example: 2957025d42e8daadf937d4044516f991d21deea4.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `clean_cache` (`boolean`, optional): If true, the cache will be cleaned before the analysis. Example: false.

Example input: `{"commit_uuid":"<commit_uuid>","provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_issue_state_update`

Ignore Or Unignore Issue · Write

Ignore a Codacy issue with a reason, or bring an ignored issue back.
Returns an empty success response.
Use Bulk Ignore Issues for many issues.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ignored` (`boolean`, required): True if the issue is ignored. Example: true.
- `issue_id` (`string`, required): Codacy issue ID, from Search Issues. Example: 67890.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `comment` (`string`, optional): Optional comment justifying the ignore action. Example: Test fixture, not production code.
- `reason` (`string`, optional): Predefined reason for ignoring the issue. Example: FalsePositive. One of: `AcceptedUse`, `FalsePositive`, `NotExploitable`, `TestCode`, `ExternalCode`.

Example input: `{"ignored":true,"issue_id":"<issue_id>","provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_issues_bulk_ignore`

Bulk Ignore Issues · Write

Ignore several Codacy issues of a repository at once.
Returns an empty success response.
Use Ignore Or Unignore Issue for a single issue.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `issue_ids` (`array`, required): List of issue ids to ignore. Example: ["67890", "67891"].
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `comment` (`string`, optional): Optional comment. Example: Generated code.
- `reason` (`string`, optional): Optional reason for ignoring. Example: FalsePositive.

Example input: `{"issue_ids":["67890","67891"],"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_organization_people_remove`

Remove Organization People · Write

Remove people from a Codacy organization by email.
Returns an empty success response.
Requires organization admin rights.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emails` (`array`, required): List of emails to add. Example: ["dev@example.com"].
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.

Example input: `{"emails":["dev@example.com"],"provider":"gh","remote_organization_name":"<remote_organization_name>"}`

### `codacy_repository_add`

Add Repository · Write

Add a Git repository to Codacy so it gets analyzed.
Returns the added repository.
Give the provider and the full path org/repository.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `repository_full_path` (`string`, required): Full path of the repository on the provider, organization/repository. Example: codacy/awesome-repo.

Example input: `{"provider":"gh","repository_full_path":"<repository_full_path>"}`

### `codacy_repository_branch_update`

Update Branch · Write

Turn Codacy analysis on or off for a repository branch.
Returns an empty success response.
Use List Branches to see current settings.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `branch_name` (`string`, required): Branch name in the repository. Example: main.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `is_enabled` (`boolean`, optional): True if Codacy should analyze the branch. Example: true.

Example input: `{"branch_name":"<branch_name>","provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_follow`

Follow Repository · Write

Follow a repository that is already added to Codacy, so it shows on your dashboard.
Returns an empty success response.
Use Unfollow Repository to stop.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

### `codacy_repository_tool_configure`

Configure Repository Tool · Write

Enable or disable an analysis tool for a Codacy repository, choose its config file use, or set patterns.
Returns an empty success response.
Use List Repository Tools for tool UUIDs.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `tool_uuid` (`string`, required): UUID of the analysis tool, from List Tools or List Repository Tools. Example: 847feb32-9ff2-11ea-bb37-0242ac130002.
- `enabled` (`boolean`, optional): Whether to enable or disable the tool. Example: true.
- `patterns` (`array`, optional): The patterns to enable or disable. Example: [{"id": "ESLint8_no-unused-vars", "enabled": true}].
- `use_configuration_file` (`boolean`, optional): Marks the tool as using a configuration file or not. Example: false.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>","tool_uuid":"<tool_uuid>"}`

### `codacy_repository_tool_patterns_update`

Update Repository Tool Patterns · Write

Enable or disable every pattern of a repository tool that matches the filters.
Returns an empty success response.
Without filters it changes all patterns of the tool.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `enabled` (`boolean`, required): True enables the code patterns, and False disables them. Example: true.
- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.
- `tool_uuid` (`string`, required): UUID of the analysis tool, from List Tools or List Repository Tools. Example: 847feb32-9ff2-11ea-bb37-0242ac130002.
- `categories` (`string`, optional): Filter by a comma-separated list of code pattern categories. Valid values are `Security`, `ErrorProne`, `CodeStyle`, `Compatibility`, `UnusedCode`, `Complexity`, `Comprehensibility`, `Documentation`, `BestPractice`, and `Performance`. Example: Security.
- `languages` (`string`, optional): Comma-separated list of programming languages to filter results by. Example: JavaScript.
- `matches_stack` (`boolean`, optional): Filter repository code patterns by whether they match the repository stack. Example: true.
- `recommended` (`boolean`, optional): Filter by recommended status. Set to `true` to return only recommended patterns, or `false` to return only non-recommended patterns. Example: true.
- `search` (`string`, optional): Text to filter results by name. Example: api.
- `severity_levels` (`string`, optional): Filter by a comma-separated list of code pattern severity levels. Valid values are `Error`, `High`, `Warning`, and `Info`. Example: Error.
- `tags` (`string`, optional): Filter by a comma-separated list of pattern tags. Example: cwe-79.

Example input: `{"enabled":true,"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>","tool_uuid":"<tool_uuid>"}`

### `codacy_security_finding_ignore`

Ignore Security Finding · Write

Ignore a Codacy security finding with a reason and comment.
Returns the updated finding.
Use Unignore Security Finding to reopen it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `srm_item_id` (`string`, required): Security finding ID (UUID), from Search Security Findings. Example: 80f64371-e6bc-4d9b-b022-7c873cc5e39f.
- `comment` (`string`, optional): Comment describing why we ignore an issue. Example: Only used in test environment.
- `reason` (`string`, optional): The reason why we ignore an issue. Must be one of `AcceptedUse`, `FalsePositive`, `NotExploitable`, `TestCode`, `ExternalCode`. Example: AcceptedUse.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","srm_item_id":"<srm_item_id>"}`

### `codacy_security_finding_unignore`

Unignore Security Finding · Write

Reopen a Codacy security finding that was ignored.
Returns the updated finding.
Use Search Security Findings to find it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `srm_item_id` (`string`, required): Security finding ID (UUID), from Search Security Findings. Example: 80f64371-e6bc-4d9b-b022-7c873cc5e39f.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","srm_item_id":"<srm_item_id>"}`

### `codacy_repository_unfollow`

Unfollow Repository · Destructive

Stop following a Codacy repository.
Returns an empty success response.
The repository keeps being analyzed.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): Git provider of the organization: gh (GitHub), gl (GitLab) or bb (Bitbucket). Example: gh. One of: `gh`, `gl`, `bb`.
- `remote_organization_name` (`string`, required): Organization name on the Git provider, as in its URL, e.g. codacy. Example: codacy.
- `repository_name` (`string`, required): Repository name inside the organization, e.g. awesome-repo. Example: awesome-repo.

Example input: `{"provider":"gh","remote_organization_name":"<remote_organization_name>","repository_name":"<repository_name>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
