Install Jentic One Beta

Connect the Codecov API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Codecov API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcodecov.com%2Fcodecov" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcodecov.com%2Fcodecov" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Codecov API.

Pull a coverage trend for a repository over time via GET /{service}/{owner}/repos/{repo}/coverage/

Compare coverage between two commits or branches with GET /{service}/{owner}/repos/{repo}/compare/

Retrieve the file-level coverage report for a single source path

List every flag (test suite or test type) configured on a repository and pull its coverage trend

GET STARTED

Start building with Codecov API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Codecov API for, with concrete tasks.

★ Pull Request Coverage Gating

Block pull requests that drop coverage below an acceptable threshold by reading commit comparison data straight from Codecov. The agent calls GET /{service}/{owner}/repos/{repo}/compare/ between the PR head and base, evaluates the delta, and posts a status check or PR comment. Replaces brittle screen-scraping of the Codecov UI with structured data.

Call GET /github/acme/repos/web/compare/ with base=main head=feature-x, and if coverage delta is below -1.0 post a failing GitHub status check

Coverage Trend Reporting

Build a multi-repository coverage trend report for engineering leadership. Each project's GET /{service}/{owner}/repos/{repo}/coverage/ feed is sampled daily, then plotted alongside flag-level coverage to show whether unit, integration, and end-to-end tests are growing or shrinking. Removes the need for ad hoc screenshots in board reviews.

For each repository in the Codecov account fetch GET /github/acme/repos/{repo}/coverage/ for the last 30 days and write the daily averages to a Snowflake table

Flaky Test Triage

Use the test results endpoint to surface flaky tests across a portfolio. The agent pulls GET /{service}/{owner}/repos/{repo}/test-results/, groups by test name, and ranks by failure rate so platform engineers can quarantine the worst offenders. Cuts the time spent staring at CI logs hunting for intermittent failures.

Pull GET /github/acme/repos/web/test-results/, group by test name, and produce a top-20 list of tests with failure rate above 5%

Component Coverage Audits

Codecov components let teams group files (for example, all billing code) and track coverage as a unit. The agent enumerates GET /{service}/{owner}/repos/{repo}/components/ and pulls comparison data per component to flag any group that drops below an internal SLA. Useful for shared services where ownership is distributed.

List components for repository 'platform' via GET /github/acme/repos/platform/components/, then for each component compare coverage between releases r-12 and r-13

Agent-Driven Coverage Lookups via Jentic

An engineer asks an agent 'is the payments service well tested?' and the Jentic-connected agent issues the right Codecov calls without holding the raw token. Jentic stores the Codecov Bearer token in its vault, returns the matching schema for the totals or trend endpoint, and executes on the agent's behalf. The user gets a one-line answer in seconds.

Search Jentic for 'get Codecov coverage totals', load the schema for GET /{service}/{owner}/repos/{repo}/totals/, execute it for the payments repo, and return the headline percentage

Key Endpoints

30 endpoints — codecov is a hosted code coverage reporting service that ingests test coverage uploads from ci pipelines and surfaces line, branch, and component-level coverage across every commit, branch, and pull request.

METHOD

PATH

DESCRIPTION

GET

/{service}/{owner_username}/repos/

List repositories under an owner

GET

/{service}/{owner_username}/repos/{repo_name}/totals/

Get coverage totals for a repository

GET

/{service}/{owner_username}/repos/{repo_name}/coverage/

Get the coverage trend

GET

/{service}/{owner_username}/repos/{repo_name}/compare/

Compare coverage between commits or branches

GET

/{service}/{owner_username}/repos/{repo_name}/file_report/{path}/

Get coverage for a single file

GET

/{service}/{owner_username}/repos/{repo_name}/components/

List components

GET

/{service}/{owner_username}/repos/{repo_name}/flags/

List flags

GET

/{service}/{owner_username}/repos/{repo_name}/test-results/

Get test results analytics

GET

/{service}/{owner_username}/repos/

List repositories under an owner

GET

/{service}/{owner_username}/repos/{repo_name}/totals/

Get coverage totals for a repository

GET

/{service}/{owner_username}/repos/{repo_name}/coverage/

Get the coverage trend

GET

/{service}/{owner_username}/repos/{repo_name}/compare/

Compare coverage between commits or branches

GET

/{service}/{owner_username}/repos/{repo_name}/file_report/{path}/

Get coverage for a single file

GET

/{service}/{owner_username}/repos/{repo_name}/components/

List components

GET

/{service}/{owner_username}/repos/{repo_name}/flags/

List flags

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Codecov by hand means choosing between its Bearer and Basic auth schemes, targeting api.codecov.io/api/v2, and threading service, owner, and repo through every coverage and comparison read yourself. Through Jentic you install once, import the Codecov API from the API Directory, store the token once, and your agent calls it.

Permission scoping

Codecov puts the service, owner, and repository in the URL path (/{service}/{owner_username}/repos/{repo_name}/...), so a rule can pin your agent to one repository: it reads that repo's totals, coverage, comparisons, components, flags, and test results and nothing else. Since these are read-only operations, you choose which of those reads the agent may call.

Credential isolation

Your Codecov token is stored once, encrypted, by your own Jentic One instance and injected at execution time as the Bearer or Basic credential. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'compare code coverage between branches' or 'get coverage totals for a repo', and Jentic returns the matching Codecov operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Codecov API through Jentic.

Does Codecov publish an official OpenAPI specification?

Yes. Codecov serves an OpenAPI 3.0.3 document from its own API host at `https://api.codecov.io/api/v2/schema/`, which reports info.version 2.0.0 and covers 34 paths with a single bearer tokenAuth scheme. The specification indexed here is a curated, agent-optimized document written and maintained by Jentic from the Codecov reference documentation, covering 30 operations with an absolute base URL the vendor document leaves relative, so consult the vendor document when you need a path this one does not list. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Codecov API use?

The Codecov v2 API supports HTTP Bearer tokens and HTTP Basic authentication. Generate a token in Codecov account settings and send it as Authorization: Bearer {token}. Through Jentic the token is stored in the vault and never enters agent context.

Can I compare coverage between two branches with the Codecov API?

Yes. GET /{service}/{owner}/repos/{repo}/compare/ accepts base and head identifiers and returns the coverage delta along with companion endpoints for impacted files, components, flags, and per-file diffs.

What are the rate limits for the Codecov API?

Codecov does not publish a fixed public rate limit. The v2 API enforces fair-use throttling, so back off on HTTP 429 responses. For portfolio-wide trend pulls, throttle to a few requests per second per token to stay within fair-use bounds.

How do I get coverage totals through Jentic?

Search Jentic for 'get Codecov coverage totals', load the schema for GET /{service}/{owner}/repos/{repo}/totals/, and execute it with the service (github, gitlab, bitbucket), owner username, and repository name. Jentic injects the Bearer token from the vault.

Does the Codecov API support write operations?

The v2 API is read-only apart from PATCH /{service}/{owner}/users/{id}, which updates a single user record. Coverage uploads themselves use the separate Codecov uploader, not this REST API.

Can I limit what my agent is allowed to do with the Codecov API?

Yes. Because Codecov puts the service, owner, and repository in the URL path, a rule in your self-hosted Jentic One instance can pin your agent to a single repository so it reads only that repo's totals, coverage trends, comparisons, components, flags, and test results. Since these operations are read-only, you decide which of those reads the agent may call and store the Bearer or Basic credential under your own rules. The agent cannot reach any repository or operation you have not allowed.

Codecov API

Name: Codecov API
Brand: Codecov API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticDeveloper ToolsTesting Qabearer, basic30 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Read line and component-level coverage, commit comparisons, and test results from Codecov for repositories integrated with GitHub, GitLab, or Bitbucket.

Use for: Get the current line coverage for a repository, Compare coverage between the main branch and a feature branch, Find which files lost coverage in the last commit, List every component defined for a Codecov repository

Not supported: Does not handle coverage uploads, repository onboarding, or static analysis - use for reading Codecov coverage, comparison, and test result data only.

Codecov is a hosted code coverage reporting service that ingests test coverage uploads from CI pipelines and surfaces line, branch, and component-level coverage across every commit, branch, and pull request. The v2 API exposes 30 endpoints over api.codecov.io, including coverage trends, file reports, commit comparisons, flags, components, and test result analytics. Authentication is Bearer token or HTTP Basic, and the API is read-only apart from a single user PATCH operation.

Jentic One on Github View OpenAPI Document