API Overview

The AgentMetrics API is a REST API. All requests use HTTPS. JSON is the request and response format.

Base URL

https://api.agentmetrics.dev/v1

Versioning

The API is versioned via path prefix (/v1). Breaking changes are introduced in new major versions. The current version is v1.

Authentication

All requests require an Authorization header with your SDK key:

Authorization: Bearer am_live_xxxxxxxxxxxxxxxxxxxx

SDK keys are prefixed with am_live_. Generate one from the Settings page in your dashboard. Keys are hashed before storage and cannot be recovered — rotate immediately if lost.

Response format

All responses are JSON.

Success

{
  "data": {
    "accepted": 1,
    "rejected": 0
  }
}

Error

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked."
  }
}

Status codes

Rate limits

Events above the monthly quota are rejected with a 429. No overages are charged. Upgrade for higher limits.