Skip to main content
The AgentMark Gateway API provides direct HTTP access to trace ingestion, scoring, and template retrieval.
Most developers should use the AgentMark SDK instead of calling the REST API directly. The SDK handles authentication, retries, and serialization automatically.

​
Base URL

All API requests are made to: 
https://api.agentmark.co
All endpoints are prefixed with /v1/ except the root health check.

​
Available Endpoints

Traces

Ingest, query, and export OpenTelemetry trace data from your AI applications.

Scoring

Create score records for spans and traces to track quality metrics and evaluation results.

Templates

Retrieve prompt templates by path for use in your application.

Health

Check service health and dependency status.

​
Response Format

All responses are JSON unless otherwise noted (e.g., CSV exports). Error responses follow a consistent format: 
{
  "error": "Description of what went wrong"
}
Validation errors include field-level details: 
{
  "error": "Validation failed",
  "details": [
    { "field": "limit", "message": "Expected number, received string" }
  ]
}

​
Rate Limiting

Requests are rate-limited per tenant. When you exceed your rate limit, the API returns a 429 status code. Trace ingestion has additional monthly span and storage quotas depending on your plan. See Authentication for details.