API Reference

The Replixa REST API lets you trigger reviews, query style graph data, and manage team configurations programmatically. Base URL: https://api.replicen.com/v1

Authentication

All API requests require a Bearer token. Generate tokens in your dashboard under Settings → API Tokens.

Authorization: Bearer rplx_your_token_here

Tokens have configurable scopes: reviews:write, graph:read, config:write. Enterprise tokens support IP allowlisting.

POST /reviews

Trigger a review on a pull request.

curl -X POST https://api.replicen.com/v1/reviews \
  -H 'Authorization: Bearer rplx_token' \
  -H 'Content-Type: application/json' \
  -d '{
    "repository": "org/repo",
    "pr_number": 4821,
    "threshold_profile": "platform-infra"
  }'

Response:

{
  "review_id": "rev_x9kmpq",
  "status": "running",
  "repository": "org/repo",
  "pr_number": 4821,
  "estimated_ms": 1400,
  "created_at": "2025-06-01T14:22:11Z"
}

GET /reviews/:id

Poll the status of a review.

curl https://api.replicen.com/v1/reviews/rev_x9kmpq \
  -H 'Authorization: Bearer rplx_token'

Response (completed):

{
  "review_id": "rev_x9kmpq",
  "status": "completed",
  "duration_ms": 1382,
  "suggestions_posted": 3,
  "suppressed": 7,
  "suggestions": [
    {
      "file": "src/services/user.ts",
      "line": 42,
      "category": "naming/service-boundary",
      "confidence": 0.91
    }
  ]
}

GET /graph/:repo

Query style graph metadata for a repository.

curl https://api.replicen.com/v1/graph/org%2Frepo \
  -H 'Authorization: Bearer rplx_token'

Response:

{
  "repository": "org/repo",
  "node_count": 2847,
  "edge_count": 6291,
  "last_updated": "2025-06-01T12:00:00Z",
  "languages": ["typescript", "python"],
  "top_patterns": [
    "service-boundary-naming",
    "repository-pattern",
    "dto-suffix-convention"
  ]
}

Rate Limits

Starter and Team plans: 100 API requests/minute. Enterprise: configurable, default 1,000/minute. Rate limit headers returned on every response: X-RateLimit-Remaining, X-RateLimit-Reset.

Error Responses

{
  "error": "repository_not_connected",
  "message": "Repository org/repo is not connected to Replixa",
  "docs": "https://replicen.com/docs/quickstart"
}