API Reference
API Overview
Overview of the Coregit REST API — base URL, authentication, errors, and pagination.
Base URL
https://api.coregit.dev/v1Authentication
Include your API key in every request:
-H "x-api-key: cgk_live_YOUR_KEY"Response Format
All responses return JSON. Successful responses use 2xx status codes. Errors follow this shape:
{
"error": "Repository not found"
}Common Status Codes
| Code | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Bad request (validation error) |
401 | Missing or invalid API key |
404 | Resource not found |
409 | Conflict (e.g., branch head changed) |
429 | Rate limited |
Pagination
List endpoints accept limit and offset query parameters:
GET /v1/repos?limit=20&offset=0limit— Number of items to return (varies by endpoint, typically max 100)offset— Number of items to skip (default: 0)
Rate Limits
- Free tier: 10,000 API calls / month
- Usage tier: Unlimited (metered billing)