Docs
v1.2.0 Stable
Base URL: api.cartnerve.com

REST API Reference

Integrate CartNerve into your custom dashboards, CLI tools, or automated deployment pipelines.

Authentication

All API requests must include your project-scoped API key in the `X-CN-API-KEY` header. You can generate keys in your project settings.

curl -H "X-CN-API-KEY: cn_live_..." https://api.cartnerve.com/v1/projects

Endpoints

GET
/v1/projects

List all monitored projects associated with your API key.

Response
{
  "data": [
    { "id": "proj_123", "name": "Production API", "status": "healthy" }
  ]
}
POST
/v1/pulses

Submit a manual telemetry pulse for a custom service metric.

Response
{
  "id": "pulse_abc889",
  "received_at": "2026-03-01T12:00:00Z",
  "analyzed": true
}
GET
/v1/incidents

Retrieve a list of active incidents and their HealBot resolution status.

Response
{
  "incidents": [
    { "id": "inc_77", "type": "latency_spike", "healed": true }
  ]
}