# Codacy

Codacy is an automated code review tool that helps developers monitor code quality, track technical debt, and enforce coding standards across multiple programming languages.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `CODACY`
- **Version:** 20260312_00

## Tools

### Create API Token

**Slug:** `CODACY_CREATE_API_TOKEN`

Creates a new account API token for the authenticated user. The token inherits all permissions from the account owner and provides access to the same organizations and repositories. Note: The token is created with default settings. To configure expiration dates or other settings, use the Codacy web interface. The newly created token can be used to authenticate API requests by including it in the 'api-token' header.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete API Token

**Slug:** `CODACY_DELETE_API_TOKEN`

Tool to delete a specific API token from the authenticated user's account. Use after confirming the token ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tokenId` | string | Yes | The ID of the API token to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Details

**Slug:** `CODACY_GET_ACCOUNT_DETAILS`

Tool to retrieve details of the authenticated user's account. Use when confirming authentication before user-level operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Configuration Status

**Slug:** `CODACY_GET_CONFIGURATION_STATUS`

Tool to retrieve the current configuration status of the Codacy system. Use when checking system setup completion or first-time configuration status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Health

**Slug:** `CODACY_GET_HEALTH`

Tool to check the health status of the Codacy API. Use when verifying API connectivity and service availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organizations Repositories Settings Languages

**Slug:** `CODACY_GET_ORGANIZATIONS_REPOSITORIES_SETTINGS_LANGUAGES`

Tool to get the list of all languages with their extensions and enabled status for a repository. Use when you need to understand which programming languages are detected and enabled for analysis in a specific Codacy repository.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string | Yes | Git provider identifier (e.g., 'gh' for GitHub, 'gl' for GitLab, 'bb' for Bitbucket). |
| `repositoryName` | string | Yes | Repository name on the Git provider organization. |
| `remoteOrganizationName` | string | Yes | Organization name on the Git provider. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tool Pattern

**Slug:** `CODACY_GET_TOOL_PATTERN`

Tool to retrieve the definition of a specific pattern for a given tool. Use when you need to get detailed information about a specific code pattern including its description, examples, parameters, and configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `toolUuid` | string | Yes | Unique identifier (UUID) for the tool. |
| `patternId` | string | Yes | Pattern identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Organizations

**Slug:** `CODACY_GET_USER_ORGANIZATIONS`

Retrieves all organizations the authenticated user belongs to for a specific Git provider. Returns organization details including name, provider, avatar, access permissions (DAST, SCA), and join status. Use this to discover which organizations a user can access on Codacy for a given Git provider (GitHub, GitLab, or Bitbucket). Requires the user to have connected the specified provider to their Codacy account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string | Yes | Git provider to list organizations from. Supported values: 'gh' (GitHub), 'gl' (GitLab), 'bb' (Bitbucket). Note: User must have connected the corresponding provider to their Codacy account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Version

**Slug:** `CODACY_GET_VERSION`

Tool to retrieve the version of the Codacy installation. Use when checking the Codacy API version for compatibility or debugging purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Analysis Organizations Repositories

**Slug:** `CODACY_LIST_ANALYSIS_ORGANIZATIONS_REPOSITORIES`

Tool to list organization repositories with analysis information for the authenticated user. Use when you need to retrieve repositories from a specific organization with their analysis status. For Bitbucket, ensure you URL encode the cursor before using it in subsequent API calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. Must be between 1 and 1000. Default is 100. |
| `cursor` | string | No | Pagination cursor. For Bitbucket, you must URL encode the cursor before using it in subsequent API calls, as the pagination comes directly from the Git provider. |
| `search` | string | No | Filter repositories by name. |
| `provider` | string | Yes | Git provider code. Valid values: 'gh' (GitHub), 'ghe' (GitHub Enterprise), 'gl' (GitLab), 'gle' (GitLab Enterprise), 'bb' (Bitbucket), 'bbe' (Bitbucket Enterprise). |
| `remoteOrganizationName` | string | Yes | Organization name on the Git provider. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Duplication Tools

**Slug:** `CODACY_LIST_DUPLICATION_TOOLS`

Tool to retrieve the list of duplication detection tools available in Codacy. Use when you need to identify which tools can analyze code duplication for different programming languages.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Languages and Tools

**Slug:** `CODACY_LIST_LANGUAGES_TOOLS`

Tool to retrieve the list of languages supported by available tools. Use when you need to determine which programming languages are supported by Codacy's analysis tools.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Login Integrations

**Slug:** `CODACY_LIST_LOGIN_INTEGRATIONS`

Tool to list configured login providers on Codacy's platform. Use when you need to discover available authentication methods for Codacy login.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return. Defaults to 100. |
| `cursor` | string | No | Cursor to specify a batch of results to request for pagination. See https://docs.codacy.com/codacy-api/using-the-codacy-api/#using-pagination |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Metrics Tools

**Slug:** `CODACY_LIST_METRICS_TOOLS`

Tool to retrieve the list of metrics tools available in Codacy. Use when you need to discover which tools calculate metrics on projects and which languages they support.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `CODACY_LIST_PROJECTS`

Tool to list all projects accessible to the authenticated user. Use when you need a list of repositories after confirming API token validity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1. |
| `search` | string | No | Filter projects by matching project name. |
| `perPage` | integer | No | Number of items per page, must be between 1 and 100. |
| `organizationName` | string | No | Filter by organization name. |
| `organizationProvider` | string | No | Filter by organization provider (e.g., 'github', 'gitlab'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Provider Integrations

**Slug:** `CODACY_LIST_PROVIDER_INTEGRATIONS`

Tool to list provider integrations existing on Codacy's platform. Use when you need to discover available Git providers that can be integrated with Codacy for authentication and repository management.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return. Defaults to 100. |
| `cursor` | string | No | Cursor to specify a batch of results to request for pagination. See https://docs.codacy.com/codacy-api/using-the-codacy-api/#using-pagination |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tools

**Slug:** `CODACY_LIST_TOOLS`

Tool to retrieve the list of analysis tools available in Codacy. Use when you need to identify which code analysis tools are available and which programming languages they support.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tools Patterns

**Slug:** `CODACY_LIST_TOOLS_PATTERNS`

Tool to retrieve the list of patterns for a specific tool. Returns code patterns that the tool can use to find issues, with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return. Default is 100. |
| `cursor` | string | No | Cursor to specify a batch of results to request (for pagination). |
| `enabled` | boolean | No | Filter by enabled status. Set to true to return only enabled patterns, or false to return only disabled patterns. |
| `toolUuid` | string | Yes | Unique identifier (UUID) for the tool. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |