FEATURES / API

Every piece of engineering intelligence, via API

RESTful API with full access to teams, contributors, sprints, code quality, risk scores, reports, and alerts. Build custom integrations, embed insights into internal tools, or automate workflows that Gitrevio doesn't cover out of the box.

Start with one curl command

# Get team health score
$ curl -s https://api.gitrevio.com/v1/teams/backend/health \
-H "Authorization: Bearer gr_live_..." \
-H "Content-Type: application/json"
{
"team": "backend",
"health_score": 0.82,
"components": {
"delivery": 0.88,
"quality": 0.79,
"collaboration": 0.85,
"sustainability": 0.76
},
"trend": "stable",
"risks": [
"knowledge_silo:auth_service",
"review_bottleneck:moderate"
],
"period": "trailing_30d"
}

API key authentication with role-based scoping. The same RBAC model as the web app — a team lead's API key returns their teams, a CTO's key returns the org.

Structured JSON responses with consistent schemas. Every endpoint returns typed, documented fields — no parsing AI-generated prose from a generic text endpoint.

Versioned API with backward compatibility guarantees. Breaking changes only in major versions, with 6-month deprecation windows.

Rate limits designed for real integrations: 1,000 requests/minute on the standard plan. Need more? Talk to us.

Endpoint coverage

Every insight available in the Gitrevio web app is accessible through the API. Build anything we can build — with your own UI, your own logic, your own workflow.

GET /v1/teams
List teams, health scores, velocity trends
GET /v1/teams/:id/sprints
Sprint history, plan vs actual, predictability
GET /v1/teams/:id/velocity
Velocity data with breakdown by contributor
GET /v1/contributors
List contributors with profiles and risk scores
GET /v1/contributors/:id/activity
Work patterns, focus time, context switching
GET /v1/contributors/:id/attrition-risk
Risk score with contributing signals
GET /v1/code-quality
Quality metrics by repo, team, or file type
GET /v1/code-quality/tech-debt
Debt hotspots, accumulation rate, ranking
GET /v1/reviews/bottlenecks
Queue depth, wait times, reviewer load
GET /v1/knowledge-graph
Ownership map, bus factors, silo analysis
POST /v1/simulate/departure
What-If analysis for team changes
GET /v1/releases/:id/risk
Per-release risk score and contributing factors
POST /v1/reports
Generate or schedule a report
POST /v1/alerts
Create or update alert configurations
GET /v1/org/health
Organization-wide health composite

Webhooks for real-time events

Don't poll — subscribe. Gitrevio sends webhook events when something changes, so your integrations can react in real time.

# Webhook payload example
{
"event": "alert.triggered",
"timestamp": "2026-03-21T14:12:00Z",
"alert": {
"type": "sprint_at_risk",
"team": "backend",
"sprint": "Sprint 44",
"severity": "high",
"projected_completion": 0.60,
"factors": [
"review_bottleneck",
"scope_creep",
"incident_response"
]
},
"signature": "sha256=..."
}

Available webhook events: alerts triggered, reports generated, health score changes, sprint status updates, attrition risk changes, and new contributor onboarding milestones.

Every payload is signed with HMAC-SHA256 so you can verify authenticity. Retry logic with exponential backoff handles transient failures on your end.

Use webhooks to power custom Slack bots, update internal dashboards, trigger CI/CD pipeline adjustments, or feed data into your own analytics stack.

API for machines. MCP for AI.

The REST API is the right choice for traditional integrations — scripts, dashboards, internal tools, data pipelines. Structured inputs, structured outputs, predictable behavior.

For AI-native access, pair the API with Gitrevio's MCP server. Your AI agents get the same data through a protocol designed for language models — with tools, prompts, and structured responses they can compose and reason about.

Same data, same RBAC, two access patterns. Use whichever fits your integration.

SDKs and tooling

Official SDKs for Node.js and Python are planned for post-v1.

OpenAPI 3.1 spec available for auto-generating clients in any language. Import directly into Postman, Insomnia, or your API testing tool of choice.

# TypeScript (coming soon)
import { Gitrevio } from '@gitrevio/sdk';
const client = new Gitrevio({
apiKey: process.env.GITREVIO_API_KEY
});
const health = await client.teams
.get('backend')
.health();
console.log(health.score); // 0.82

Build on top of your engineering intelligence.

Get started free