# Codecov

Codecov: repos, commits, branches, pulls, coverage, components, flags. Exposes **22 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `codecov_owners_list` | List all owners under a service - GET /{service}/owners. |
| `codecov_owner_get` | Get one owner/organization - GET /{service}/{owner}. |
| `codecov_repos_list` | List repositories under an owner - GET /{service}/{owner}/repos. |
| `codecov_repo_get` | Get one repository - GET /{service}/{owner}/repos/{repo}. |
| `codecov_repo_config_update` | Update repository configuration - PATCH /{service}/{owner}/repos/{repo}. |
| `codecov_commits_list` | List commits in a repository - GET /{service}/{owner}/repos/{repo}/commits. |
| `codecov_commit_get` | Get one commit - GET /{service}/{owner}/repos/{repo}/commits/{commit_sha}. |
| `codecov_branches_list` | List branches in a repository - GET /{service}/{owner}/repos/{repo}/branches. |
| `codecov_branch_get` | Get one branch - GET /{service}/{owner}/repos/{repo}/branches/{branch}. |
| `codecov_pulls_list` | List pull requests - GET /{service}/{owner}/repos/{repo}/pulls. |
| `codecov_pull_get` | Get one pull request - GET /{service}/{owner}/repos/{repo}/pulls/{pull_number}. |
| `codecov_components_list` | List components in a repository - GET /{service}/{owner}/repos/{repo}/components. |
| `codecov_component_get` | Get one component - GET /{service}/{owner}/repos/{repo}/components/{component_id}. |
| `codecov_flags_list` | List flags in a repository - GET /{service}/{owner}/repos/{repo}/flags. |
| `codecov_flag_get` | Get one flag - GET /{service}/{owner}/repos/{repo}/flags/{flag_name}. |
| `codecov_coverage_total` | Get coverage totals - GET /{service}/{owner}/repos/{repo}/coverage. |
| `codecov_coverage_trend` | Get coverage trend - GET /{service}/{owner}/repos/{repo}/coverage/trend. |
| `codecov_report_get` | Get coverage report - GET /{service}/{owner}/repos/{repo}/reports/{commit_sha}. |
| `codecov_report_files` | Get report files - GET /{service}/{owner}/repos/{repo}/reports/{commit_sha}/files. |
| `codecov_test_results_list` | List test results - GET /{service}/{owner}/repos/{repo}/test_results. |
| `codecov_users_list` | List users - GET /users. |
| `codecov_user_get` | Get one user - GET /users/{user_id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`CODECOV_API_TOKEN`** - Codecov - Settings - Access - API Token. (https://app.codecov.io/account)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CODECOV_API_TOKEN` | Codecov - Settings - Access - API Token. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Codecov API documentation](https://docs.codecov.com/reference)